डेवलपर्स
इनवॉइस बनाएं
एक POST रिक्वेस्ट से इनवॉइस बनता है और पेमेंट पेज का लिंक मिलता है। ग्राहक वहां एक कॉइन और नेटवर्क चुनता है।
रिक्वेस्ट
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"}'| फील्ड | अर्थ |
|---|---|
amount | आवश्यक। 0.01 से शुरू होने वाला एक नंबर। USDT में एक न्यूनतम सीमा है क्योंकि जब मर्चेंट फीस देता है तो वह इनवॉइस से ज्यादा नहीं हो सकती: मौजूदा न्यूनतम सीमा के लिए GET /api/payments/quote कॉल करें। |
currency | आवश्यक। फिएट (RUB, USD, EUR, CNY, GBP, CHF, JPY, KZT और अन्य प्रमुख करेंसी) या USDT/USDC। राशि को लाइव रेट पर कन्वर्ट किया जाता है। |
order_id | आपकी अपनी order id, 80 कैरेक्टर तक। खाली होने पर, CryBit CB-… जनरेट करता है। |
purpose | विवरण, 240 कैरेक्टर तक। |
ttl_minutes | लाइफटाइम 5 से 1440 मिनट तक, डिफॉल्ट रूप से 30। |
return_url | पेमेंट के बाद ग्राहक कहां लौटता है (http या https, 500 कैरेक्टर तक)। न होने पर मर्चेंट के return URL का उपयोग होता है। |
crypto, network | वैकल्पिक। रिस्पॉन्स में एक साथ एड्रेस, राशि और QR कोड पाने के लिए दोनों पास करें, उदाहरण के लिए USDT और TRC-20। |
confirmation | वैकल्पिक। एम्बेडेड विजेट के लिए {"type":"embedded"}। टोकन हमेशा रिस्पॉन्स में होता है। |
रिस्पॉन्स
रिस्पॉन्स 201 होता है और उसमें invoice ऑब्जेक्ट होता है। ग्राहक को callback_url (पेमेंट पेज) पर भेजें। crypto और network न देने पर needs_method true होता है और ग्राहक उस पेज पर चुनाव करता है।
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"
}स्टेटस
GET /api/v1/payments/{uuid} वही ऑब्जेक्ट लौटाता है। स्टेटस waiting, paid, expired या cancelled हो सकता है। ग्राहक द्वारा नेटवर्क चुनने के बाद ऑब्जेक्ट में crypto, network, address और फीस होती है; पेमेंट के बाद इसमें status paid, txid और paid_at होता है। लाइफटाइम खत्म होने के बाद waiting इनवॉइस को पूछने पर expired दिखाया जाता है। fee_payer, shop होता है जब मर्चेंट फीस देता है, और buyer होता है जब देय राशि में फीस पहले से शामिल होती है।
FAQ
मुझे कौन-से हेडर भेजने चाहिए?
X-Public-Key और X-Private-Key, दोनों आवश्यक हैं। गायब, गलत या पुरानी private key पर 401 रिटर्न होता है।
क्या कोई रेट लिमिट है?
प्रति key प्रति मिनट 60 रिक्वेस्ट।