Documentação da API
Tudo que você precisa para integrar cobranças, transferências e webhooks. Base: https://app.r2gate.com.br/api/v1.
Autenticação
Toda requisição leva as chaves da conta nos cabeçalhos X-Api-Key e X-Api-Secret. As chaves são geradas no painel, em Desenvolvedor, e podem ser restritas a uma lista de IPs.
Endpoints
| Método | Rota | Função |
|---|---|---|
| POST | /create_charge.php | Cria cobrança Pix (QR + copia e cola) |
| GET | /get_charge_status.php | Consulta status da cobrança |
| POST | /create_withdraw.php | Cria transferência Pix por chave |
| GET | /withdraw_status.php | Consulta status da transferência |
Webhooks
Cadastre a URL no painel. Eventos: payment.received, withdraw.completed e pix.failed. Cada envio leva assinatura HMAC com o segredo da conta; se a sua URL não responder 2xx, reenviamos em até 4 tentativas.
Guias de integração
1. Criar e confirmar uma cobrança
Crie a cobrança com external_id do seu pedido, mostre o QR ao cliente e trate o webhook payment.received. Use get_charge_status como reserva.
2. Pagar um parceiro por Pix
Chame create_withdraw com a chave e um external_id único. Repetir a chamada com o mesmo id não gera segundo pagamento.
3. Testar sem dinheiro real
Use as chaves de homologação do painel. Todas as rotas respondem com dados fictícios.