Desarrolladores
Widget integrado
El cliente paga sin salir de su dominio. Usted crea la factura a través de la API y muestra el formulario de pago de CryBit en su propia página.
1. Cree una factura
Use el mismo POST /api/v1/payments. La respuesta siempre contiene confirmation.confirmation_token, que es igual al uuid de la factura. El campo confirmation en la solicitud es opcional.
2. Cargue el script y agregue un contenedor
HTML
<script src="https://pay.crybit.net/widget.js"></script>
<div id="payment-form"></div>3. Muestre el formulario
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())Ventana modal
Si no hay un contenedor en la página, abra el widget sobre el sitio con customization: { modal: true } (o modal: true) y llame a checkout.render() sin argumentos.
Opciones y eventos
| Opción | Significado |
|---|---|
confirmation_token | Obligatorio. El uuid de la factura (alias: uuid, invoice_uuid). |
return_url | Adónde va el cliente después del pago. |
lang | Idioma de la interfaz; de lo contrario, el idioma del navegador. |
modal / customization.modal | true para una ventana emergente en lugar de un contenedor. |
error_callback, success_callback | Se invoca ante un error (sin token, sin contenedor) y cuando el estado pasa a paid. |
Eventos: ready, status, success, fail, complete, close, error. Métodos: render(id), on(event, fn), destroy().
Confirme el pedido por webhook o consultando el estado. El evento del widget es solo para la interfaz de usuario.
FAQ
¿Puedo probar el widget?
Sí. En un comercio de prueba el widget muestra un botón para marcar la factura como pagada y el saldo no se acredita.