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.

Yeni API entegrasyonu

Entegrasyonu sıfırdan siz yazıyorsunuz.

Başka bir ağ geçidinden geçiş

Kodunuzu koruyun: uyumlu API'ler, yalnızca temel URL'yi ve anahtarları değiştirirsiniz.

Entegrasyonu yapay zekâya bırakın

Kod yazmayan ama yapay zekâ destekli kodlama aracı kullananlar için.

Araçlar

Tarayıcınızda çalışan hata ayıklama yardımcıları.

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.

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

1. Ana sayfadan erişim isteyin. Onaylanınca satıcı paneline giriş yapın.
2. 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.
3. Sunucunuz POST /v1/payment ile bir fatura oluşturur ve müşteriyi result.url adresine yönlendirir.
4. Ö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.
5. Live sütunundaki kimlik bilgilerine geçin ve bir kez küçük bir gerçek tutar ödeyin (panelin ana sayfasında “Bir ödeme dene”).

POST https://blockwallets.io/v1/payment
merchant: <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 dokümanlarındadır; işi yapay zekâya yaptırmak isterseniz prompt oluşturucu 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 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

<a href="https://blockwallets.io/l/pl_…" target="_blank" rel="noopener nofollow"
   style="display:inline-flex;align-items:center;height:44px;padding:0 22px;border-radius:999px;background:#1f5a3d;color:#ffffff;font:600 16px/1 sans-serif;text-decoration:none">Pay with crypto</a>

HTML + script

<a href="https://blockwallets.io/l/pl_…" target="_blank" rel="noopener nofollow"
   data-blockwallets data-color="green" data-size="m" data-shape="pill">Pay with crypto</a>
<script src="https://blockwallets.io/embed.js" async></script>