Bravive Payments API

Bem-vindo à documentação da API de Pagamentos Bravive. Nossa API permite que você processe pagamentos de forma segura e eficiente em sua aplicação.

Autenticação

Todas as requisições à API precisam ser autenticadas usando um token de acesso. Você pode obter suas credenciais no painel administrativo.

Mantenha suas chaves de API seguras e nunca as compartilhe publicamente.

Obtendo o Token

1. Acesse o Painel Administrativo
2. Navegue até Configurações > API Keys
3. Clique em "Gerar Nova Chave"

Usando o Token

Inclua o token no header Authorization de todas as requisições:

curl https://app.bravive.com/v1/payments \
  -H "Authorization: Bearer seu_token_aqui" \
  -H "Content-Type: application/json"

fetch('https://app.bravive.com/v1/payments', {
  headers: {
    'Authorization': 'Bearer seu_token_aqui',
    'Content-Type': 'application/json'
  }
})

import requests

headers = {
    'Authorization': 'Bearer seu_token_aqui',
    'Content-Type': 'application/json'
}

response = requests.get('https://app.bravive.com/v1/payments', headers=headers)

Rate Limiting

Por padrão, a API limita as requisições a:

1000 requisições por minuto para o ambiente de produção

Webhooks

Os webhooks permitem que você receba notificações em tempo real sobre eventos importantes em sua conta. Configure URLs de webhook no painel administrativo para receber atualizações automáticas.

Configuração

Para configurar um webhook, você precisa:

Acessar o painel administrativo
Navegar até Configurações > Webhooks
Adicionar uma nova URL de webhook
Selecionar os eventos que deseja receber

Eventos Disponíveis

Você pode configurar webhooks para os seguintes eventos:

Eventos de Pagamento:

on_transaction_created - Quando um pagamento é criado
on_transaction_updated - Quando um pagamento é atualizado
on_transaction_approved - Quando um pagamento é aprovado
on_transaction_rejected - Quando um pagamento é rejeitado
on_transaction_canceled - Quando um pagamento é cancelado
on_transaction_chargeback - Quando ocorre um chargeback
on_transaction_refunded - Quando um pagamento é reembolsado

Eventos de Saque:

on_withdraw_created - Quando um saque é criado
on_withdraw_updated - Quando um saque é atualizado
on_withdraw_approved - Quando um saque é aprovado
on_withdraw_rejected - Quando um saque é rejeitado

Formato do Payload

O payload do webhook varia de acordo com o tipo de evento:

{
  "id": "string",
  "type": "PAYMENT",
  "status": "APPROVED | REJECTED | CANCELED | CHARGEBACK | REFUNDED | IN_DISPUTE",

}

{
  "id": "string",
  "type": "WITHDRAW",
  "withdraw_status": "APPROVED | REJECTED | CANCELED | CHARGEBACK | REFUNDED | IN_DISPUTE",

}

Os webhooks são enviados via POST para a URL configurada. Certifique-se de que seu endpoint esteja preparado para receber requisições POST e retornar um status 200 para confirmar o recebimento.

Em caso de falha na entrega do webhook, nosso sistema fará automaticamente até 3 tentativas de reenvio, com intervalo de 5 minutos entre cada tentativa.

Importante

Nunca use tokens de produção em ambiente de desenvolvimento ou compartilhe suas credenciais. Em caso de comprometimento das suas chaves, gere novas imediatamente através do painel administrativo.