# Yapay zekâyla entegrasyon · blockwallets

> Kod yazmadan blockwallets kripto ödemelerini ekleyin: sitenizi ve yapay zekâ aracınızı seçin, oluşturulan prompt'u Claude Code, Codex, Cursor ya da ChatGPT'ye kopyalayın; dokümanlardan entegre eder ve kendi işini kontrol eder.
>
> HTML: https://blockwallets.io/docs/ai?lang=tr · English: https://blockwallets.io/docs/ai.md?lang=en

## Genel prompt

```text
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.
```

## Bize sitenizi anlatın.

Emin değil misiniz? “Diğer / emin değilim”i seçin; yapay zekâ önce projenize bakar.

- Sitenizin yapıldığı teknoloji: WordPress / WooCommerce · PHP · Node.js / Next.js · Python · Go · Java · Diğer / emin değilim
- Ödemeyi nasıl almak istiyorsunuz:
  - Ödeme sayfasına yönlendirme: Ödeme adımında bir fatura oluşturun, ödenince sunucunuza haber veririz. Siparişler kendiliğinden gönderilir.
  - Kullanıcı başına sabit yükleme adresi: Her kullanıcı kalıcı bir adres alır ve istediği zaman istediği tutarı yükler.
  - Ödeme bağlantısı (kodsuz): Panelde bir bağlantı oluşturup paylaşın. Yapay zekâ yalnızca bir düğme ekler.

Ö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.

## Hangi yapay zekâyı kullanıyorsunuz?

- **Claude Code / Codex**: Kodunuzu düzenleyen ve komut çalıştıran yapay zekâ. En kolayı.
  - 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.md`
  - Codex AGENTS.md dosyasını kendiliğinden okur. Claude Code için ayrıca şunu çalıştırın:
  - `echo '@AGENTS.md' >> CLAUDE.md`
  - Ardı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. https://blockwallets.io/docs/mcp?lang=tr
- **Cursor / Windsurf / Copilot**: Kod editörünüzün içindeki yapay zekâ.
  - AGENTS.md dosyasını proje köküne koyun (Cursor onu otomatik alır):
  - `curl -fsSL https://blockwallets.io/agents.md -o AGENTS.md`
  - Agent 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. https://blockwallets.io/docs/mcp?lang=tr
- **ChatGPT / Claude (web)**: Yalnızca sohbet. Kodu siteye kendiniz yapıştırırsınız.
  - 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.
- **Başka bir yapay zekâ**: Gemini, Copilot sohbeti ve diğerleri.
  - Prompt'u yapıştırın. Web sayfalarını açamıyorsa llms-full.txt içeriğini de yapıştırın.

## Prompt'u kopyalayın.

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.

Örnek: Diğer / emin değilim + ödeme sayfasına yönlendirme + Claude Code / Codex

```text
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â bitirdiğinde şunları kontrol edin

**Ödeme sayfasına yönlendirme**

1. Test kimlik bilgileriyle bir test faturası oluştur ve ödeme sayfası bağlantısını (result.url) al
2. Ödeme sayfasını aç ve “Ödemeyi simüle et” → tam tutar seçeneğine tıkla
3. Sunucum status paid olan bir webhook alıyor ve imza doğrulanıyor
4. İlgili sipariş ödenmiş olarak işaretleniyor
5. 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

**Kullanıcı başına sabit yükleme adresi**

1. Test kimlik bilgileriyle bir test kullanıcısı için adres aç ve adresi ile yükleme sayfası bağlantısını al
2. POST /v1/test-webhook/wallet ile bir örnek webhook gönder
3. Sunucum type wallet olan bir webhook alıyor ve imza doğrulanıyor
4. O kullanıcının bakiyesi payment_amount_usd kadar artıyor
5. Aynı webhook tekrar geldiğinde bakiye iki kez yüklenmiyor

**Ödeme bağlantısı (kodsuz)**

1. Düğme masaüstünde ve telefonda doğru görünüyor
2. Düğme ödeme bağlantımı açıyor (önce Test modunda oluşturulmuş bir bağlantı kullan)
3. Ödeme sayfasında “Ödemeyi simüle et”e tıklamak, ödemeyi panelde “Ödemeler › İşlemler” altında gösteriyor

## Yapay zekâ takıldığında.

- **İmza hiç doğrulanmıyor**: Ham webhook gövdesini [imza denetleyiciye](https://blockwallets.io/docs/sign?lang=tr) 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.
- **Bir endpoint hata döndürüyor**: 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.
- **Nerede takıldığından emin değilsiniz**: 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.

### Sizin göz kulak olacağınız dört şey.

- **Yapay zekâya yalnızca Test kimlik bilgilerini verin**: Test merchant ID'si ve API key testnet'lerde çalışır; sızsalar bile para hareket ettirilemez.
- **Live API key'i sohbetlerden uzak tutun**: 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â düzenlemeden önce yedekleyin**: Yapay zekâ başlamadan önce sitenizin dosyalarını commit edin (git commit) ya da kopyalayın; böylece geri dönebilirsiniz.
- **Canlıya geçmeden önce bir kez kendiniz ödeyin**: 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.

## Kodlama ajanları için bir 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.

```sh
curl -fsSL https://blockwallets.io/agents.md -o AGENTS.md
echo '@AGENTS.md' >> CLAUDE.md
```

- [Entegrasyon kuralları (AGENTS.md)](https://blockwallets.io/agents.md)
- [Tek sayfalık özet](https://blockwallets.io/llms.txt)
- [Tam dokümanlar](https://blockwallets.io/llms-full.txt)
- [Bu sayfa Markdown olarak](https://blockwallets.io/docs/ai.md?lang=tr)
- [Dokümanlar Markdown olarak](https://blockwallets.io/docs.md?lang=tr)
- [MCP sunucusu](https://blockwallets.io/docs/mcp?lang=tr)

## Sorular, yanıtlar.

### Kod yazmasam da yapay zekâyla gerçekten entegre edebilir miyim?

Ç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.

### Hangi yapay zekâ aracını kullanmalıyım?

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.

### API key'imi yapay zekâya vermeli miyim?

Yalnızca Test kimlik bilgilerini, o da sohbet yerine bir ortam dosyasında. Live API key'i sunucunuza kendiniz koyun.

### Webhook imzası hiç doğrulanmıyor. Şimdi ne yapmalı?

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.

### Yapay zekâ bitirdiğini söylüyor. Nasıl kontrol ederim?

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.