Sviluppatori
Widget integrato
Il cliente paga senza lasciare il tuo dominio. Crei la fattura tramite l'API e mostri il modulo di pagamento CryBit nella tua pagina.
1. Crea una fattura
Usa lo stesso POST /api/v1/payments. La risposta contiene sempre confirmation.confirmation_token, che equivale all'uuid della fattura. Il campo confirmation nella richiesta è facoltativo.
2. Carica lo script e aggiungi un container
HTML
<script src="https://pay.crybit.net/widget.js"></script>
<div id="payment-form"></div>3. Mostra il modulo
JavaScript
const checkout = new CryBitCheckout({
confirmation_token: 'INVOICE-UUID',
return_url: 'https://merchant.example/thanks',
lang: 'en',
error_callback: (err) => console.log(err),
})
checkout.render('payment-form').then(() => { /* the form is shown */ })
checkout.on('success', () => { /* status paid: confirm the order by webhook or GET */ })
checkout.on('fail', () => { /* expired, cancelled or refunded */ })
checkout.on('complete', () => checkout.destroy())Finestra modale
Se non c'è alcun container nella pagina, apri il widget sopra il sito con customization: { modal: true } (oppure modal: true) e chiama checkout.render() senza argomenti.
Opzioni ed eventi
| Opzione | Significato |
|---|---|
confirmation_token | Obbligatorio. L'uuid della fattura (alias: uuid, invoice_uuid). |
return_url | Dove va il cliente dopo il pagamento. |
lang | Lingua dell'interfaccia; altrimenti la lingua del browser. |
modal / customization.modal | true per un pop-up invece di un container. |
error_callback, success_callback | Chiamato in caso di errore (nessun token, nessun container) e quando lo stato diventa paid. |
Eventi: ready, status, success, fail, complete, close, error. Metodi: render(id), on(event, fn), destroy().
Conferma l'ordine tramite webhook o leggendo lo stato. L'evento del widget serve solo per l'interfaccia utente.
FAQ
Posso testare il widget?
Sì. In un merchant di test il widget mostra un pulsante per contrassegnare la fattura come pagata e il saldo non viene accreditato.