Sviluppatori
API di pagamento crypto
Tre chiamate: crea una fattura, leggi il suo stato, leggi il saldo. Il cliente paga nella pagina di pagamento e tu ricevi un webhook e USDT.
Endpoint
| Metodo | Cosa fa |
|---|---|
POST /api/v1/payments | Crea una fattura e ottieni il link alla pagina di pagamento |
GET /api/v1/payments/{uuid} | Stato, indirizzo e id della transazione |
GET /api/v1/wallet | Saldo USDT disponibile e congelato |
URL di base: https://api.crybit.net · JSON · 60 richieste al minuto · autenticazione: header X-Public-Key e X-Private-Key.
Crea una fattura
Gli unici campi obbligatori sono amount e currency. Passa il tuo order_id per abbinare il pagamento a un ordine, e ttl_minutes per impostare la durata.
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 e widget
Quando una fattura viene pagata, CryBit chiama l'URL webhook del tuo merchant così puoi evadere l'ordine. Per mantenere il cliente sul tuo sito, richiedi il tipo di conferma embedded e apri il modulo di pagamento con lo script del widget.
Riferimento
FAQ
Come mi autentico?
Invia la chiave pubblica in X-Public-Key e la chiave privata in X-Private-Key. Entrambi gli header sono obbligatori. Il merchant viene identificato dalla chiave pubblica, quindi non serve alcun id del negozio nella richiesta.
Esiste una modalità test?
Sì. Un merchant in modalità test crea fatture sandbox: la pagina di pagamento ha un pulsante per contrassegnarle come pagate, e non modificano il tuo saldo. Passa il merchant alla modalità live per accettare trasferimenti reali.
Quali sono i limiti?
L'API accetta 60 richieste al minuto per chiave. L'importo della fattura parte da 0.01, e la durata va da 5 a 1440 minuti.
