Geliştiriciler
Fatura oluşturun
Tek bir POST isteği fatura oluşturur ve ödeme sayfasının bağlantısını döndürür. Müşteri coin ve ağı orada seçer.
İstek
curl
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"}'| Alan | Anlamı |
|---|---|
amount | Zorunlu. 0.01'den başlayan bir sayı. USDT cinsinden bir minimum vardır, çünkü komisyonu üye işyeri öderse ağ komisyonu fatura tutarını aşamaz: güncel minimum için GET /api/payments/quote uç noktasını sorgulayın. |
currency | Zorunlu. Fiat (RUB, USD, EUR, CNY, GBP, CHF, JPY, KZT ve diğer büyük para birimleri) veya USDT/USDC. Tutar anlık kurla çevrilir. |
order_id | Kendi sipariş kimliğiniz, en fazla 80 karakter. Boş bırakılırsa CryBit CB-… oluşturur. |
purpose | Açıklama, en fazla 240 karakter. |
ttl_minutes | 5 ila 1440 dakika arası geçerlilik süresi, varsayılan 30. |
return_url | Ödemeden sonra müşterinin döneceği adres (http veya https, en fazla 500 karakter). Belirtilmezse üye işyerinin dönüş URL'sine düşer. |
crypto, network | İsteğe bağlı. Adresi, tutarı ve QR kodu yanıtta hemen almak için ikisini birlikte gönderin, örneğin USDT ve TRC-20. |
confirmation | İsteğe bağlı. Gömülü widget için {"type":"embedded"}. Token her zaman yanıtta bulunur. |
Yanıt
Yanıt, fatura nesnesiyle birlikte 201'dir. Müşteriyi callback_url adresine (ödeme sayfası) yönlendirin. crypto ve network olmadan needs_method true olur ve müşteri seçimi o sayfada yapar.
JSON
{
"uuid": "28d0ff38-949c-435e-ad41-c81c219b3597",
"order_id": "ORD-1048",
"amount": 1490,
"currency": "RUB",
"status": "waiting",
"sandbox": true,
"needs_method": true,
"callback_url": "https://pay.crybit.net/28d0ff38-949c-435e-ad41-c81c219b3597",
"confirmation": { "type": "embedded", "confirmation_token": "28d0ff38-…", "widget_url": "https://pay.crybit.net/widget.js" },
"expires_at": "2026-09-21T13:41:42+00:00"
}Durum
GET /api/v1/payments/{uuid} aynı nesneyi döndürür. Durum waiting, paid, expired veya cancelled olur. Müşteri bir ağ seçtikten sonra nesnede crypto, network, address ve komisyon bulunur; ödemeden sonra status paid, txid ve paid_at bulunur. Geçerlilik süresini aşmış waiting durumundaki bir fatura, sorgulandığında expired olur. fee_payer, komisyonu üye işyeri ödüyorsa shop, ödenecek tutar komisyonu zaten içeriyorsa buyer olur.
FAQ
Hangi başlıkları göndermeliyim?
X-Public-Key ve X-Private-Key, ikisi de zorunludur. Eksik, yanlış veya eski bir gizli anahtar 401 döndürür.
İstek sınırı var mı?
Anahtar başına dakikada 60 istek.