Início Rápido
Uma API. Todos os pagamentos.
Uma única integração conecta sua aplicação a PIX, transferências LATAM e criptomoedas. Adicione novos métodos de pagamento sem reescrever uma linha de código.
Integre em 3 passos
Autentique-se
Envie client_id e client_secret via Basic Auth para POST /v2/oauth/token. Você recebe um access_token válido por 1 hora.
Execute a operação
Use o token em qualquer endpoint — PIX, cripto, SPEI. Sempre o mesmo formato de request e response, independente do método de pagamento.
Receba a confirmação
Informe uma postback_url e a BSPAY envia um webhook no momento em que o pagamento é confirmado. Sem polling.
Autenticação
Primeira cobrança
Uma chamada. O QR Code (ou endereço cripto) volta na resposta.
O campo de pagamento muda conforme o método:
| Método | Onde encontrar os dados |
|---|---|
| PIX | data.payment_info.qrcode |
| Cripto | data.payment_info.address + data.payment_info.chain |
| SPEI | data.payment_info.clabe |
Webhook de confirmação
Pagamento confirmado? A BSPAY dispara um POST para sua postback_url automaticamente.
Responda HTTP 200 para confirmar recebimento. Falhou? Reenviamos até 5 vezes com backoff progressivo.
Próximos passos
- Autenticação — OAuth2, tokens e ciclo de vida das credenciais
- Cash-in — todos os parâmetros, moedas e redes suportadas
- Cash-out — envie para PIX, crypto ou contas bancárias
- Webhooks — eventos, retry, validação de assinatura
