Әзірлеушілерге
Крипто төлем API-і
Үш шақыру: инвойс жасау, оның статусын оқу, балансты оқу. Клиент төлем бетінде төлейді, ал сізге webhook пен USDT келеді.
Endpoint-тер
| Әдіс | Не істейді |
|---|---|
POST /api/v1/payments | Инвойс жасау және төлем бетінің сілтемесін алу |
GET /api/v1/payments/{uuid} | Статус, мекенжай және транзакция идентификаторы |
GET /api/v1/wallet | Қолжетімді және мұздатылған USDT балансы |
Негізгі URL: https://api.crybit.net · JSON · минутіне 60 сұраныс · аутентификация: X-Public-Key және X-Private-Key тақырыптары.
Инвойс жасау
Тек amount және currency өрістері міндетті. Төлемді тапсырыспен сәйкестендіру үшін өз order_id-іңізді, ал жарамдылық мерзімін белгілеу үшін ttl_minutes-ты беріңіз.
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-тар мен виджет
Инвойс төленген кезде CryBit мерчантыңыздың webhook URL мекенжайын шақырады, сол арқылы тапсырысты босата аласыз. Клиентті сайтыңызда қалдыру үшін confirmation type embedded сұраңыз да, төлем формасын widget скрипті арқылы ашыңыз.
Анықтамалық
Вопросы и ответы
Аутентификацияны қалай жасаймын?
Ашық кілтті X-Public-Key-де, жеке кілтті X-Private-Key-де жіберіңіз. Екі тақырып та міндетті. Мерчант ашық кілт бойынша анықталады, сондықтан сұранысқа дүкен идентификаторы қажет емес.
Тест режимі бар ма?
Иә. Тест режиміндегі мерчант sandbox инвойстарын жасайды: төлем бетінде оларды төленген деп белгілейтін түйме бар, және олар балансыңызды өзгертпейді. Нақты аударымдарды қабылдау үшін мерчантты нақты режимге ауыстырыңыз.
Шектеулер қандай?
API әрбір кілт үшін минутіне 60 сұранысты қабылдайды. Инвойс сомасы 0.01-ден басталады, ал жарамдылық мерзімі 5-тен 1440 минутқа дейін.
