Әзірлеушілерге
Инвойс жасау
Бір 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 | Өз тапсырыс идентификаторыңыз, 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. Клиентті 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 және fee болады; төлемнен кейін status paid, txid және paid_at болады. Жарамдылық мерзімі өткен waiting инвойсы сіз сұраған кезде expired болады. Мерчант комиссияны төлегенде fee_payer — shop, ал төленетін сомаға комиссия қосылып қойылған болса — buyer.
Вопросы и ответы
Қандай тақырыптар жіберемін?
X-Public-Key және X-Private-Key, екеуі де міндетті. Жоқ, қате немесе ескі жеке кілт 401 қайтарады.
Сұраныс шегі бар ма?
Әр кілт үшін минутіне 60 сұраныс.