Developer
Buat invoice
Satu permintaan POST membuat invoice dan mengembalikan tautan ke halaman pembayaran. Pelanggan memilih koin dan jaringan di sana.
Permintaan
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"}'| Field | Arti |
|---|---|
amount | Wajib. Angka mulai dari 0.01. Ada minimum dalam USDT karena biaya jaringan tidak boleh melebihi invoice saat merchant yang menanggungnya: panggil GET /api/payments/quote untuk minimum terkini. |
currency | Wajib. Fiat (RUB, USD, EUR, CNY, GBP, CHF, JPY, KZT, dan mata uang utama lainnya) atau USDT/USDC. Jumlah dikonversi pada kurs terkini. |
order_id | ID pesanan Anda sendiri, maksimal 80 karakter. Jika kosong, CryBit membuat CB-…. |
purpose | Deskripsi, maksimal 240 karakter. |
ttl_minutes | Masa berlaku 5 hingga 1440 menit, default 30. |
return_url | Tujuan pelanggan kembali setelah pembayaran (http atau https, maksimal 500 karakter). Jika kosong, memakai return URL merchant. |
crypto, network | Opsional. Kirim keduanya untuk langsung mendapatkan alamat, jumlah, dan kode QR di respons, misalnya USDT dan TRC-20. |
confirmation | Opsional. {"type":"embedded"} untuk widget tertanam. Token selalu ada di respons. |
Respons
Responsnya 201 dengan objek invoice. Arahkan pelanggan ke callback_url (halaman pembayaran). Tanpa crypto dan network, needs_method bernilai true dan pelanggan memilih di halaman tersebut.
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"
}Status
GET /api/v1/payments/{uuid} mengembalikan objek yang sama. Statusnya waiting, paid, expired, atau cancelled. Setelah pelanggan memilih jaringan, objek memuat crypto, network, address, dan biaya; setelah pembayaran, objek memuat status paid, txid, dan paid_at. Invoice waiting yang melewati masa berlakunya menjadi expired saat Anda memintanya. fee_payer bernilai shop jika merchant yang menanggung biaya dan buyer jika jumlah yang harus dibayar sudah mencakupnya.
FAQ
Header apa yang harus saya kirim?
X-Public-Key dan X-Private-Key, keduanya wajib. Private key yang hilang, salah, atau lama akan mengembalikan 401.
Apakah ada batas permintaan?
60 permintaan per menit per key.