Sviluppatori
Crea una fattura
Una singola richiesta POST crea una fattura e restituisce il link alla pagina di pagamento. Lì il cliente sceglie una moneta e una rete.
Richiesta
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"}'| Campo | Significato |
|---|---|
amount | Obbligatorio. Un numero a partire da 0.01. Esiste un minimo in USDT perché la commissione di rete non può superare la fattura quando è il merchant a pagarla: richiedi GET /api/payments/quote per il minimo attuale. |
currency | Obbligatorio. Fiat (RUB, USD, EUR, CNY, GBP, CHF, JPY, KZT e altre valute principali) oppure USDT/USDC. L'importo viene convertito al tasso in tempo reale. |
order_id | Il tuo order id, fino a 80 caratteri. Se vuoto, CryBit genera CB-…. |
purpose | Descrizione, fino a 240 caratteri. |
ttl_minutes | Durata da 5 a 1440 minuti, 30 di default. |
return_url | Dove torna il cliente dopo il pagamento (http o https, fino a 500 caratteri). In assenza, viene usato l'URL di ritorno del merchant. |
crypto, network | Facoltativo. Passa entrambi per ottenere subito nella risposta l'indirizzo, l'importo e un codice QR, per esempio USDT e TRC-20. |
confirmation | Facoltativo. {"type":"embedded"} per il widget integrato. Il token è sempre presente nella risposta. |
Risposta
La risposta è 201 con l'oggetto fattura. Invia il cliente a callback_url (la pagina di pagamento). Senza crypto e network, needs_method è true e il cliente sceglie in quella pagina.
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"
}Stato
GET /api/v1/payments/{uuid} restituisce lo stesso oggetto. Lo stato è waiting, paid, expired o cancelled. Dopo che il cliente ha scelto una rete, l'oggetto contiene crypto, network, address e la commissione; dopo il pagamento contiene status paid, txid e paid_at. Una fattura waiting oltre la sua durata diventa expired quando la richiedi. fee_payer è shop quando la commissione la paga il merchant, e buyer quando l'importo da pagare la include già.
FAQ
Quali header devo inviare?
X-Public-Key e X-Private-Key, entrambi obbligatori. Una chiave privata mancante, errata o non aggiornata restituisce 401.
Esiste un limite di frequenza?
60 richieste al minuto per chiave.