Desenvolvedores
Widget incorporado
O cliente paga sem sair do seu domínio. Você cria a fatura pela API e exibe o formulário de pagamento da CryBit na sua própria página.
1. Crie uma fatura
Use o mesmo POST /api/v1/payments. A resposta sempre contém confirmation.confirmation_token, que é igual ao uuid da fatura. O campo confirmation na requisição é opcional.
2. Carregue o script e adicione um contêiner
HTML
<script src="https://pay.crybit.net/widget.js"></script>
<div id="payment-form"></div>3. Exiba o formulário
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())Janela modal
Se não houver um contêiner na página, abra o widget sobre o site com customization: { modal: true } (ou modal: true) e chame checkout.render() sem argumentos.
Opções e eventos
| Opção | Significado |
|---|---|
confirmation_token | Obrigatório. O uuid da fatura (aliases: uuid, invoice_uuid). |
return_url | Para onde o cliente vai após o pagamento. |
lang | Idioma da interface; caso contrário, o idioma do navegador. |
modal / customization.modal | true para um pop-up em vez de um contêiner. |
error_callback, success_callback | Chamado em caso de erro (sem token, sem contêiner) e quando o status passa a paid. |
Eventos: ready, status, success, fail, complete, close, error. Métodos: render(id), on(event, fn), destroy().
Confirme o pedido pelo webhook ou consultando o status. O evento do widget serve apenas para a interface do usuário.
FAQ
Posso testar o widget?
Sim. Em um merchant de teste, o widget mostra um botão para marcar a fatura como paga e o saldo não é creditado.