Développeurs
Widget intégré
Le client paie sans quitter votre domaine. Vous créez la facture via l'API et affichez le formulaire de paiement CryBit sur votre propre page.
1. Créer une facture
Utilisez le même POST /api/v1/payments. La réponse contient toujours confirmation.confirmation_token, qui correspond à l'uuid de la facture. Le champ confirmation dans la requête est facultatif.
2. Charger le script et ajouter un conteneur
HTML
<script src="https://pay.crybit.net/widget.js"></script>
<div id="payment-form"></div>3. Afficher le formulaire
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())Fenêtre modale
S'il n'y a pas de conteneur sur la page, ouvrez le widget par-dessus le site avec customization: { modal: true } (ou modal: true) et appelez checkout.render() sans argument.
Options et événements
| Option | Signification |
|---|---|
confirmation_token | Obligatoire. L'uuid de la facture (alias : uuid, invoice_uuid). |
return_url | Où le client est redirigé après le paiement. |
lang | Langue de l'interface ; sinon la langue du navigateur. |
modal / customization.modal | true pour une fenêtre pop-up au lieu d'un conteneur. |
error_callback, success_callback | Appelé en cas d'erreur (pas de token, pas de conteneur) et lorsque le statut devient paid. |
Événements : ready, status, success, fail, complete, close, error. Méthodes : render(id), on(event, fn), destroy().
Confirmez la commande via le webhook ou en consultant le statut. L'événement du widget concerne uniquement l'interface utilisateur.
FAQ
Puis-je tester le widget ?
Oui. Dans un marchand de test, le widget affiche un bouton pour marquer la facture comme payée, et le solde n'est pas crédité.