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

MetodoCosa fa
POST /api/v1/paymentsCrea una fattura e ottieni il link alla pagina di pagamento
GET /api/v1/payments/{uuid}Stato, indirizzo e id della transazione
GET /api/v1/walletSaldo 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 page

Webhook 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.

Correlati