İmza hiç doğrulanmıyor
Ham webhook gövdesini imza denetleyiciye yapıştırın. Her ara adımı gösterir ve ilk farkı işaretler; yapay zekânıza tam olarak neyin farklı olduğunu söyleyin.
Kod yazmanız gerekmez. Sitenizi ve yapay zekâ aracınızı seçin, oluşturduğumuz prompt'u ona verin; dokümanlarımızdan entegre eder, ardından kendi işini madde madde kontrol eder.
Genel prompt · seçim gerekmez
Web sitemde blockwallets ile kripto ödeme almama yardım et (müşteriler USDT, USDC, BTC ve daha fazlasıyla öder; bana ABD doları olarak yatırılır). 1. API'yi tahmin etmek yerine önce dokümanları oku: https://blockwallets.io/llms-full.txt (tam dokümanlar) ve https://blockwallets.io/agents.md (entegrasyon kuralları, sık yapılan hatalar, kabul kontrol listesi). Açamazsan söyle. 2. Projeme bak, neyle yazıldığını ve nasıl entegre etmeyi planladığını söyle, onayımı bekle. 3. Varsayılan olarak “fatura oluştur ve ödeme sayfasına yönlendir + webhook” yöntemini kullan. Webhook imzalarını her zaman doğrula ve webhook'ları tekilleştir, çünkü aynısı iki kez gelebilir. 4. merchant ID'yi ve API key'i ortam değişkenlerinde tut; önce Test kimlik bilgileriyle testnet'lerde çalıştır. 5. Bitirdiğinde agents.md içindeki kabul kontrol listesini madde madde gözden geçir ve her sonucu söyle. Programcı değilim: her adımda neyi değiştirdiğini ve benim ne yapmam gerektiğini söyle.
Açmak, prompt'un tamamını panonuza kopyalar; bağlantı yalnızca kısa bir giriş taşır. Açıldığında bir kez yapıştırın.
Sitenize uyan bir prompt mu istiyorsunuz? Aşağıda üç adım var. ↓
1. adım
Emin değil misiniz? “Diğer / emin değilim”i seçin; yapay zekâ önce projenize bakar.
Ödeme bağlantıları kod gerektirmez: panel → “Ödemeler › Ödeme bağlantıları” → bir tutar girin → oluşturun, sonra bağlantıyı paylaşın. Yapay zekâ yalnızca sitenize bir düğme koyar.
Paneli aç2. adım
Her araç dokümanları farklı okur; kendi aracınıza uyan adımları izleyin.
Web sitenizin proje klasöründe bir terminal açın ve entegrasyon kurallarını AGENTS.md olarak kaydedin:
curl -fsSL https://blockwallets.io/agents.md -o AGENTS.mdCodex AGENTS.md dosyasını kendiliğinden okur. Claude Code için ayrıca şunu çalıştırın:
echo '@AGENTS.md' >> CLAUDE.mdArdından 3. adımdaki prompt'u yapıştırın.
Yapay zekânın dokümanlarda arama yapıp doğrudan test faturaları oluşturabilmesi için blockwallets MCP sunucusunu da kurabilirsiniz.MCP kurulumu →
AGENTS.md dosyasını proje köküne koyun (Cursor onu otomatik alır):
curl -fsSL https://blockwallets.io/agents.md -o AGENTS.mdAgent moduna geçin ve prompt'u yapıştırın.
Yapay zekânın dokümanlarda arama yapıp doğrudan test faturaları oluşturabilmesi için blockwallets MCP sunucusunu da kurabilirsiniz.MCP kurulumu →
Prompt'u yeni bir sohbete yapıştırın ya da aşağıdaki “ChatGPT / Claude'da aç” seçeneğini kullanın.
Bağlantıları açamadığını söylerse https://blockwallets.io/llms-full.txt adresini açın, tümünü seçip kopyalayın ve onu da yapıştırın.
Size eksiksiz kodu ve nereye koyacağınızı verir; adım adım izleyin. Kodu sizin yerinize düzenleyen bir araç (Claude Code, Codex, Cursor) çok fazla kopyala-yapıştırdan kurtarır.
Prompt'u yapıştırın. Web sayfalarını açamıyorsa llms-full.txt içeriğini de yapıştırın.
3. adım
Yukarıdaki seçimlerinize göre güncellenir ve doküman bağlantılarını, sık yapılan hataları ve bir kabul kontrol listesini içerir.
Sen benim geliştiricimsin. Web sitemde blockwallets ile kripto ödeme almama yardım et (müşteriler USDT, USDC, BTC ve 14 başka coin ile öder; bana ABD doları olarak yatırılır).
## Hakkımda
- Sitem şununla yapıldı: Emin değilim. Önce projeme bak, neyle yazıldığını söyle, sonra başla.
- Ödemeyi nasıl almak istiyorum: Ödeme adımında bir fatura oluştur ve müşteriyi blockwallets ödeme sayfasına yönlendir; para gelince blockwallets sunucumu çağırır, ben de siparişi ödenmiş olarak işaretleyip göndereyim.
- Programcı değilim. Her adımda hangi dosyaları değiştirdiğini ve benim ne yapmam gerektiğini (örneğin ortam değişkenlerini nereye koyacağımı) söyle. Bir seferde çok fazla şey değiştirme.
- Proje kökündeki AGENTS.md blockwallets entegrasyon kurallarını içerir; önce onu oku, ayrıntılar için https://blockwallets.io/llms-full.txt dosyasını oku.
## Önce dokümanları oku; API'yi hafızadan tahmin etme
- Tam entegrasyon dokümanları (Markdown): https://blockwallets.io/llms-full.txt
- Entegrasyon kuralları ve sık yapılan hatalar: https://blockwallets.io/agents.md
- Site zaten Cryptomus, NOWPayments veya Coinbase Commerce kullanıyorsa yeniden yazmak yerine ilgili uyumlu API'ye geçir: https://blockwallets.io/docs/migrate.md?lang=en
- Bir bağlantıyı açamazsan söyle, içeriği ben yapıştırayım.
## Önemli noktalar (entegrasyonların genelde takıldığı yerler)
1. Her endpoint https://blockwallets.io üzerinde POST + JSON'dur. Başlıklar: merchant = merchant UUID'si, sign = md5(base64(istek gövdesi) + API key). Gönderdiğin JSON dizesini birebir imzala; imzaladıktan sonra yeniden serileştirme.
2. POST /v1/payment ile bir fatura oluştur. Zorunlu: amount (en çok iki ondalıklı bir dize, örn. "42.00"), currency ("USD"), order_id (sipariş numaram: harfler, rakamlar, - ve _, en çok 100 karakter). Ayrıca url_callback (webhook URL'si) ve url_success (müşterinin ödemeden sonra döneceği yer) ilet. Müşteriyi result.url adresine yönlendir.
3. Aynı order_id ile tekrar çağırmak aynı faturayı döndürür; yani tekrar denemek güvenlidir ve asla ikinci bir fatura oluşturmaz.
4. Webhook imzaları doğrulanmalıdır: webhook JSON'unu ayrıştır, sign alanını çıkar, geri kalanı PHP json_encode gibi yeniden kodla (sıkıştırılmış, ASCII dışı karakterler korunmuş, / karakteri \/ olarak kaçırılmış), ardından md5(base64(kodlanmış) + API key) değeri sign ile eşit olmalıdır. / karakterini kaçırmayı unutmak en sık yapılan hatadır.
5. Siparişi yalnızca status paid ya da paid_over olduğunda ve payment_amount_usd kullanarak ödenmiş işaretle. Aynı webhook birden fazla kez gelebilir: uuid + status ile tekilleştir. İşledikten sonra 2xx durum koduyla yanıt ver.
6. merchant ID'yi ve API key'i ortam değişkenlerinde tut (örn. BW_MERCHANT, BW_API_KEY); asla koda gömme ya da commit etme. Önce panelin “Geliştiriciler › Entegrasyon ve anahtarlar” sayfasındaki “Web sitesi alan adları” bölümüne webhook URL'sinin alan adını ekle.
7. Önce her şeyi Test kimlik bilgileriyle çalıştır (testnet'ler, gerçek para yok); Live'a ancak ben onayladıktan sonra geç.
## Bitirdiğinde her maddeyi kontrol et ve sonucu söyle
- [ ] Test kimlik bilgileriyle bir test faturası oluştur ve ödeme sayfası bağlantısını (result.url) al
- [ ] Ödeme sayfasını aç ve “Ödemeyi simüle et” → tam tutar seçeneğine tıkla
- [ ] Sunucum status paid olan bir webhook alıyor ve imza doğrulanıyor
- [ ] İlgili sipariş ödenmiş olarak işaretleniyor
- [ ] Aynı webhook tekrar geldiğinde (panelin “Geliştiriciler › Webhook günlüğü”nden ya da POST /v1/payment/resend ile yeniden gönder) sipariş iki kez gönderilmiyor
Bir madde başarısız olursa başka bir şey değiştirmeden önce nerede takıldığını ve tam hata mesajını söyle.
Yapay zekâdan her sonucu bildirmesini isteyin. Hepsi geçince Live'a geçin.
Takıldınız mı?
Sorunların çoğu imzadır. Ham metin, yapay zekâya bir açıklamadan çok daha fazla yardımcı olur.
Ham webhook gövdesini imza denetleyiciye yapıştırın. Her ara adımı gösterir ve ilk farkı işaretler; yapay zekânıza tam olarak neyin farklı olduğunu söyleyin.
Tam isteği ve yanıtı (message dahil) yapay zekânıza geri yapıştırın. İmza yanlış olduğunda 401 yanıtındaki debug.body_base64, imzaladığımız metindir; yapay zekâya kendi metniyle karşılaştırtın.
Yapay zekâdan kabul kontrol listesini ilk maddeden başlayarak tek tek gözden geçirmesini ve her sonucu bildirmesini isteyin. Panelin “Geliştiriciler › Webhook günlüğü” sayfası her webhook isteğini ve sunucunuzun yanıtını gösterir.
Güvenlik
Test merchant ID'si ve API key testnet'lerde çalışır; sızsalar bile para hareket ettirilemez.
Live API key'i sunucunuzun ortam değişkenlerine kendiniz koyun. Asla bir sohbete yapıştırmayın veya bir depoya commit etmeyin.
Yapay zekâ başlamadan önce sitenizin dosyalarını commit edin (git commit) ya da kopyalayın; böylece geri dönebilirsiniz.
Live'a geçtikten sonra panel ana sayfasındaki “Bir ödeme dene” ile küçük bir gerçek tutar ödeyin ve siparişin ödenmiş olduğunu, bakiyenin ulaştığını kontrol edin.
Kural dosyası
AGENTS.md entegrasyonun özünü, sık yapılan hataları ve kabul kontrol listesini içerir. Proje kökünüze koyun: Codex ve Cursor onu otomatik okur, Claude Code @AGENTS.md ile içe aktarır.
curl -fsSL https://blockwallets.io/agents.md -o AGENTS.mdecho '@AGENTS.md' >> CLAUDE.mdYapay zekâ için dosyalar
SSS
Çoğu site için evet. Yapay zekâ, fatura oluşturma ve imza kodunu dokümanlardan yazar; siz kimlik bilgilerini ortam değişkenlerine koyar ve test modunda kabul kontrol listesini tek tek geçersiniz. Hiç kod istemiyorsanız ödeme bağlantılarını kullanın.
Projenizi düzenleyen ve komut çalıştıran bir araç en kolayıdır: Claude Code, Codex ya da Cursor. Web'de ChatGPT veya Claude da çalışır, ancak kodu siteye kendiniz yapıştırırsınız.
Yalnızca Test kimlik bilgilerini, o da sohbet yerine bir ortam dosyasında. Live API key'i sunucunuza kendiniz koyun.
sign'ı çıkarın, geri kalanı PHP json_encode gibi yeniden kodlayın ve / karakterini \/ olarak kaçırın. Her adımı karşılaştırmak için ham webhook gövdesini /docs/sign sayfasına yapıştırın, ardından yapay zekâya neyin farklı olduğunu söyleyin.
Kabul kontrol listesini çalıştırın: bir test faturası oluşturun, ödemeyi simüle edin, webhook'un doğrulandığını görün, siparişin ödenmiş işaretlendiğini görün ve aynı webhook'u yeniden göndererek hiçbir şeyin iki kez gönderilmediğini doğrulayın. Canlıya geçmeden önce küçük bir Live tutarı ödeyin.