REASON REASON
Acessar
Voltar para a página inicial
Developer API Hub v2.0

Documentação da API & Integrações

Ambiente: Produção & Sandbox (mTLS / OAuth2 Bearer) RACIOCINA TECH LTDA — CNPJ: 66.425.285/0001-10

A API REST da Reason Gateway permite que desenvolvedores, ERPs e plataformas de e-commerce processem pagamentos instantâneos via Pix, cartões de crédito e faturamento internacional com segurança mTLS e webhooks em tempo real.

1. Autenticação OAuth2

POST /v1/auth

Troca segura de credenciais Client ID e Client Secret por um token de acesso Bearer válido por 600 segundos.

curl -X POST "https://api.reasonget.com/v1/auth" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials&client_id=SEU_CLIENT_ID&client_secret=SEU_SECRET"

2. Emissão de Cobrança Pix Dinâmica

POST /v2/pix/cob

Gera uma ordem Pix dinâmica com QR Code em tempo real e chave Copia e Cola para pagamento instantâneo.

curl -X POST "https://api.reasonget.com/v2/pix/cob" \
  -H "Authorization: Bearer {SEU_TOKEN}" \
  -H "Content-Type: application/json" \
  -d '{
    "calendario": { "expiracao": 3600 },
    "devedor": { "cpf": "00000000000", "nome": "Cliente Exemplo" },
    "valor": { "original": "49.90" },
    "solicitacaoPagador": "Pedido #1042 Reason Gateway"
  }'

3. Webhooks & Notificações em Tempo Real

POST https://sua-loja.com/webhook/reason

Payload enviado automaticamente aos servidores do lojista assim que a liquidação financeira D+0 é confirmada pelo Banco Central.

{
  "evento": "pix.pagamento_confirmado",
  "txid": "REASON1792707741668ABCDEF",
  "valor": "49.90",
  "endToEndId": "E00000000202610231600abcdef",
  "horario": "2026-10-23T16:00:00Z",
  "status": "CONCLUIDA"
}