# blockwallets dokümanları: entegrasyon yolları > Bir entegrasyon seçin: kodsuz ödeme bağlantıları, POS ve gömülü butonlar; Cryptomus uyumlu API ya da yerel REST API; Cryptomus, NOWPayments ve Coinbase Commerce için uyumlu API'ler; yapay zekâ prompt'ları, AGENTS.md ve MCP. > > HTML: https://blockwallets.io/docs?lang=tr · English: https://blockwallets.io/docs.md?lang=en ## Dokümanlar blockwallets ile USDT ve USDC, ayrıca BTC, LTC ve ağların kendi coin'lerini kabul edersiniz (sabitlenen kurla ABD doları olarak yatırılır). Aşağıdaki her entegrasyon aynı barındırılan ödeme sayfasında aynı türde faturayı, aynı onay sayısı, ücret ve bakiyeyle oluşturur; yalnızca sisteminizin bizimle nasıl konuştuğu değişir. Size uyanı seçin, sonra sayfasındaki adımları izleyin. ### Bir entegrasyon seçin Nereden başladığınıza göre gruplandı. Her kart tam rehberi açar. #### Kodsuz Satıcı panelinden ödeme alın; kurulacak bir şey yok. - [Ödeme bağlantıları](https://blockwallets.io/docs?lang=tr#links): Bir tutar girin (ya da ödeyenin yazmasına izin verin) ve bağlantıyı ya da QR kodunu paylaşın. Her ziyaret yeni bir fatura oluşturur. - [Mağazalar için POS](https://blockwallets.io/docs?lang=tr#pos): Personel bir telefonda ya da tablette POS bağlantısını açar, tutarı yazar ve müşteri QR kodunu okutur. - [Gömülü buton](https://blockwallets.io/docs?lang=tr#embed): Herhangi bir siteye “Öde” ya da “Bağış yap” butonu yapıştırın: düz HTML ya da HTML artı tek bir script etiketi. #### Yeni API entegrasyonu Entegrasyonu sıfırdan siz yazıyorsunuz. - [Yerel REST API](https://blockwallets.io/docs/api?lang=tr): Bearer anahtarı, sent cinsinden tutarlar, idempotent `ref`, HMAC-SHA256 webhook'lar ve bir events API. Anahtarlar panelden kendiniz oluşturulur. - [Cryptomus uyumlu API](https://blockwallets.io/docs/cryptomus?lang=tr): md5 imzalı POST + JSON. Kimlik bilgilerini panelden kendiniz oluşturursunuz, her başlıca endpoint'te bir “Dene” paneli vardır. #### Başka bir ağ geçidinden geçiş Kodunuzu koruyun: uyumlu API'ler, yalnızca temel URL'yi ve anahtarları değiştirirsiniz. - [Cryptomus'tan](https://blockwallets.io/docs/cryptomus?lang=tr#cryptomus): `https://api.cryptomus.com` adresini `https://blockwallets.io` olarak değiştirin ve yeni bir merchant ile API key kullanın. Yollar, parametreler, `sign` ve webhook'lar aynı kalır. - [NOWPayments'tan](https://blockwallets.io/docs/nowpayments?lang=tr): `https://api.nowpayments.io/v1` adresini `https://blockwallets.io/nowpayments/v1` olarak değiştirin ve yeni bir API key ile IPN secret kullanın. `x-nowpayments-sig` aynı kalır. - [Coinbase Commerce'ten](https://blockwallets.io/docs/coinbase-commerce?lang=tr): SDK temel URL'si olarak `https://blockwallets.io/coinbase/` verin ve yeni bir API key ile webhook shared secret kullanın. `X-CC-Webhook-Signature` aynı kalır. #### Entegrasyonu yapay zekâya bırakın Kod yazmayan ama yapay zekâ destekli kodlama aracı kullananlar için. - [Prompt oluşturucu](https://blockwallets.io/docs/ai?lang=tr): Sitenizi, ödeme biçiminizi ve yapay zekâ aracınızı seçin; Claude Code, Codex, Cursor ya da ChatGPT için hazırlanan prompt'u kopyalayın. - [AGENTS.md](https://blockwallets.io/agents.md): Entegrasyon kuralları, sık yapılan hatalar ve bir kabul kontrol listesi; kodlama ajanları için proje kök dizinine kaydedin. - [MCP server](https://blockwallets.io/docs/mcp?lang=tr): Bir yapay zekâ aracının bu dokümanlarda arama yapmasına ve doğrudan test faturaları oluşturmasına izin verin. #### Araçlar Tarayıcınızda çalışan hata ayıklama yardımcıları. - [İmza denetleyici](https://blockwallets.io/docs/sign?lang=tr): Bir istek ya da webhook gövdesini yapıştırın; her imzalama adımını ve sizinkinin nerede farklılaştığını görün. API key tarayıcınızdan hiç çıkmaz. ### Cryptomus uyumlu mu, yerel mi? İkisi de aynı ödeme sayfasında aynı faturaları, aynı ücret ve bakiyeyle oluşturur. Fark; istek biçiminde, webhook biçiminde ve kimlik bilgilerini nasıl aldığınızdadır. | | Cryptomus uyumlu | Yerel REST | | --- | --- | --- | | Kimlik bilgileri | Panelde “Geliştiriciler › Entegrasyon ve anahtarlar” altında kendiniz oluşturursunuz (Live için bir, Test için bir takım) | Bunlar da panelde “Geliştiriciler › Entegrasyon ve anahtarlar” altında kendiniz oluşturulur: bir Live ve bir Test anahtarı (`bw_live_…` / `bw_test_…`) ile bunların webhook signing secret'ları | | İstekler | Her çağrı `POST` + JSON'dur; `merchant` ve `sign` = `md5(base64(istek gövdesi) + API key)` başlıklarıyla | `Authorization: Bearer` ile REST (`GET` / `POST`); anahtar öneki Live mı Test mi olduğunu belirler | | Tutarlar | `"42.00"` gibi ondalık dizeler; USD, USDT veya USDC cinsinden (hepsi 1:1) | `4200` gibi ABD senti cinsinden tam sayılar; yalnızca USD | | Yeniden deneme | Aynı `order_id` mevcut faturayı döndürür | Aynı parametrelerle aynı `ref` mevcut faturayı döndürür; farklı parametreler 409 döndürür | | Webhook'lar | Her faturanın `url_callback` adresine gönderilir; imza, gövdedeki `sign` alanıdır | Panelde ayarlanan webhook URL'sine gönderilir; `X-BW-Signature` = zaman damgalı HMAC-SHA256; `/v1/events` ile listelenir ve yeniden gönderilir | | Statik adresler | `/v1/wallet`: çağrı başına bir ağ | `/v1/deposit-accounts`: bir müşteri için tüm ağlar birden | | Araçlar | “Dene” panelleri, imza denetleyici, yapay zekâ prompt'ları ve MCP server; mevcut Cryptomus SDK'ları ve eklentileri çalışır | Bu başvuru dokümanı ve kod örnekleri | Sıfırdan mı başlıyorsunuz? Yerel REST API'yi kullanın: sent cinsinden tutarlar, idempotent `ref`, zaman damgalı webhook imzaları ve panelde kendiniz oluşturduğunuz anahtarlar. Zaten Cryptomus kullanıyorsanız veya mevcut bir Cryptomus SDK'sı ya da eklentisi kullanmak istiyorsanız Cryptomus uyumlu API'yi kullanın. ### Hızlı başlangıç Sıfırdan bir test ödemesine beş adımda (Cryptomus uyumlu API; diğer API'ler aynı adımları kendi kimlik bilgileriyle izler). - [Ana sayfadan](https://blockwallets.io/?lang=tr#join) erişim isteyin. Onaylanınca [satıcı paneline](https://blockwallets.io/dashboard) giriş yapın. - Panelde “Geliştiriciler › Entegrasyon ve anahtarlar” bölümünü açın, Test sütununda bir merchant ve API key oluşturun ve web sitesi alan adlarınızı ekleyin. - Sunucunuz `POST /v1/payment` ile bir fatura oluşturur ve müşteriyi `result.url` adresine yönlendirir. - Ödeme sayfasında “Ödemeyi simüle et” ile ödeyin, sonra webhook işleyicinizin `sign` değerini doğruladığını ve `payment_amount_usd` kadar yüklediğini kontrol edin. - Live sütunundaki kimlik bilgilerine geçin ve bir kez küçük bir gerçek tutar ödeyin (panelin ana sayfasında “Bir ödeme dene”). ```http POST https://blockwallets.io/v1/payment merchant: sign: md5(base64(body) + API key) Content-Type: application/json { "amount": "42.00", "currency": "USD", "order_id": "order_1042", "url_callback": "https://shop.example/webhooks/crypto", "url_return": "https://shop.example/cart", "url_success": "https://shop.example/thanks?order=1042" } ``` Her adımın Node.js, PHP ve Python kodları [Cryptomus uyumlu API](https://blockwallets.io/docs/cryptomus?lang=tr#api) dokümanlarındadır; işi yapay zekâya yaptırmak isterseniz [prompt oluşturucu](https://blockwallets.io/docs/ai?lang=tr) ile başlayın. ### Ödeme bağlantıları (kodsuz) Satıcı paneli → “Ödemeler › Ödeme bağlantıları” → açıklama ve tutar girin (bir ağı sabitleyin ya da müşteri seçsin) → oluşturun. Her bağlantının bir URL'si ve bir QR kodu vardır. - Biri bağlantıyı her açtığında yeni bir fatura oluşturulur, yani tek bağlantı tekrar tekrar kullanılabilir (örn. “Üyelik $99”). - Her ödeme “Ödemeler › İşlemler” altında görünür; “Fonlar › Bakiye ve çekim” bölümünden cüzdanınıza çekin. - “Geliştiriciler › Entegrasyon ve anahtarlar” altında kimlik bilgileri ve bir webhook URL'si oluşturduysanız, bağlantılarla yapılan ödemeler de [Cryptomus uyumlu webhook biçiminde](https://blockwallets.io/docs/cryptomus?lang=tr#webhooks) bildirilir. - Kabulü durdurmak için “Devre dışı bırak”a tıklayın; bağlantı hemen çalışmayı bırakır. ### Mağazalar için POS Kasalar ve tezgâhlar için: satıcı paneli → “Ödemeler › POS kasa” → bir terminal açın ve POS bağlantısını alın. Personel bunu telefonda ya da tablette açar, tutarı yazar ve bir ödeme QR kodu belirir; müşteri ödeyince ekranda “Paid” görünür. - Bir POS faturası 30 dakika geçerlidir. Ödemeler bakiyenize gider ve “Ödemeler › İşlemler” altında görünür; ödeme bağlantılarında olduğu gibi webhook URL'nizde bildirim alırsınız. - Bir POS bağlantısı yalnızca ödeme alabilir: bakiyenizi, çekimlerinizi, diğer siparişleri, ayarları ya da kimlik bilgilerinizi göremez. - Bir cihaz mı kayboldu, bir personel mi ayrıldı? Panelde o terminali iptal edin; bağlantısı hemen çalışmayı bırakır. ### Gömülü buton Satıcı paneli → “Ödemeler › Ödeme bağlantıları” → “Gömülü buton”: metni, rengi, boyutu ve şekli seçin, kod parçasını kopyalayın. Butona tıklamak o ödeme bağlantısının ödeme sayfasını açar. - Düz HTML: script içermeyen biçimlendirilmiş tek bir bağlantı; HTML yapıştırabildiğiniz her yerde çalışır (site oluşturucular, forumlar, e-posta imzaları). - Script ile: `data-blockwallets` ekleyin ve bir `/embed.js` etiketi koyun; masaüstünde ödeme sayfası ortada küçük bir pencerede açılır, telefonlarda normal şekilde açılır. - Script istek göndermez, çerez bırakmaz ve iframe eklemez. Sayfa onu engellerse buton yine çalışan sıradan bir bağlantı olarak kalır. Aşağıdaki kod parçalarında `/l/pl_…` yerine kendi ödeme bağlantınızın adresini yazın. #### Düz HTML ```html Pay with crypto ``` #### HTML + script ```html Pay with crypto ```