Geliştiriciler
Kripto ödeme API'si
Üç çağrı: fatura oluşturma, durumunu okuma, bakiyeyi okuma. Müşteri ödeme sayfasında öder, siz webhook ve USDT alırsınız.
Endpoint'ler
| Metot | Ne işe yarar |
|---|---|
POST /api/v1/payments | Fatura oluşturur ve ödeme sayfası bağlantısını verir |
GET /api/v1/payments/{uuid} | Durum, adres ve işlem kimliği |
GET /api/v1/wallet | Kullanılabilir ve dondurulmuş USDT bakiyesi |
Temel URL: https://api.crybit.net · JSON · dakikada 60 istek · kimlik doğrulama: X-Public-Key ve X-Private-Key başlıkları.
Fatura oluşturun
Yalnızca amount ve currency alanları zorunludur. Ödemeyi bir siparişle eşleştirmek için kendi order_id değerinizi, geçerlilik süresini belirlemek için ttl_minutes değerini gönderin.
curl -X POST https://api.crybit.net/api/v1/payments \
-H "X-Public-Key: pk_…" \
-H "X-Private-Key: sk_…" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"amount":1490,"currency":"RUB","order_id":"ORD-1048","purpose":"Order 1048"}'JavaScript
const invoice = await fetch('https://api.crybit.net/api/v1/payments', {
method: 'POST',
headers: {
'X-Public-Key': 'pk_…',
'X-Private-Key': 'sk_…',
Accept: 'application/json',
'Content-Type': 'application/json',
},
body: JSON.stringify({ amount: 1490, currency: 'RUB', order_id: 'ORD-1048' }),
}).then((r) => r.json())
location.href = invoice.callback_url // the payment pageWebhook'lar ve widget
Bir fatura ödendiğinde CryBit, siparişi tamamlayabilmeniz için üye işyerinizin webhook URL'sini çağırır. Müşteriyi sitenizde tutmak için confirmation türü olarak embedded isteyin ve ödeme formunu widget betiğiyle açın.
Referans
FAQ
Kimlik doğrulama nasıl yapılır?
Açık anahtarı X-Public-Key, gizli anahtarı X-Private-Key başlığıyla gönderin. Her iki başlık da zorunludur. Üye işyeri açık anahtardan tanındığı için istekte mağaza kimliği gerekmez.
Test modu var mı?
Evet. Test modundaki bir üye işyeri sandbox faturaları oluşturur: ödeme sayfasında bunları ödendi olarak işaretlemek için bir düğme bulunur ve bakiyenizi değiştirmezler. Gerçek transferleri kabul etmek için üye işyerini canlı moda geçirin.
Limitler nelerdir?
API, anahtar başına dakikada 60 isteği kabul eder. Fatura tutarı 0.01'den başlar, geçerlilik süresi 5 ila 1440 dakikadır.
