Voltar para documentação
Integrações

Integração Braip

Conecte sua conta Braip ao Synchro Hub para receber vendas em tempo real e consolidar métricas no dashboard.

Conecte sua conta Braip ao Synchro Hub para receber vendas em tempo real e consolidar métricas no dashboard.

Visão geral

Ao integrar a Braip, o Synchro Hub passa a:

  • Receber webhooks (postbacks) de vendas, reembolsos, chargebacks, assinaturas e carrinhos abandonados em tempo real.
  • Consultar a API da Braip para importar histórico e enriquecer dados.

Tempo estimado: 10 minutos. O que você vai precisar:

  • Conta Braip com perfil de Produtor (ou Co-produtor com permissão).
  • Workspace já criado no Synchro Hub.

Pré-requisitos

  • Estar logado no Synchro Hub com um workspace selecionado.
  • Ter acesso ao painel da Braip em ev.braip.com.

Passo 1 — Gerar o Token de Integração na Braip

  1. Entre no painel da Braip em ev.braip.com.
  2. No menu, acesse Ferramentas → Integrações → API.
  3. Clique em Gerar Token (ou Novo Token) e dê um nome (ex.: Synchro Hub).
  4. Copie o Token de Integração exibido. Guarde-o — você vai colá-lo no Passo 3.

Importante: o token da Braip dá acesso total à sua conta via API. Nunca compartilhe.

Passo 2 — Conectar a plataforma no Synchro Hub

  1. No menu lateral, acesse Integrações.
  2. Clique em + Adicionar Plataforma.

Tela de Integrações

  1. Selecione Braip e clique em Confirmar.

Modal de seleção de plataforma

Passo 3 — Salvar o Token de Integração

  1. No card da Braip, clique em Atualizar credenciais.
  2. Cole o Token de Integração copiado no Passo 1.
  3. Clique em Salvar.

Modal de credenciais Braip

O Synchro Hub valida o token em tempo real conectando-se à Braip. Se estiver inválido ou expirado, você verá o aviso Token expirado no card da integração.

Card com token expirado

Passo 4 — Configurar o webhook na Braip

  1. No card da Braip, clique em Configurar Webhook.
  2. Copie a URL do Webhook exibida. O formato é: 
    https://api.synchrohub.com.br/v1/webhooks/braip/{seu-integration-id}

Modal de configuração do webhook

  1. Em outra aba, abra ev.braip.com → Ferramentas → Postbacks (ou Webhooks).
  2. Clique em Adicionar Postback.
  3. Cole a URL copiada no campo de URL.
  4. Marque os eventos recomendados:
    • Venda aprovada
    • Venda recusada
    • Venda cancelada
    • Venda reembolsada
    • Chargeback
    • Boleto gerado
    • Venda expirada
    • Assinatura cancelada
    • Carrinho abandonado
  5. Informe/gere um Token de validação (chave única de verificação do postback) e salve.

Importante: a Braip permite que você defina a chave de validação do postback. Guarde-a — é esse valor que vai no campo Token do Webhook no próximo passo.

Passo 5 — Ativar o webhook no Synchro Hub

  1. Volte para o modal Webhook Braip no Synchro Hub.
  2. Cole a chave de validação (definida na Braip) no campo Token do Webhook.
  3. Clique em Ativar Webhook.

O card da integração passa a exibir Webhook ativo.

Verificação

Para confirmar que tudo está funcionando:

  1. Gere uma venda de teste na Braip (use um cupom de 100% em um produto seu ou uma compra real de valor baixo).
  2. Abra Vendas no menu lateral do Synchro Hub.
  3. A venda deve aparecer em até 1 minuto após a aprovação na Braip.

Solução de problemas

SintomaO que fazer
”Token expirado” no cardGere um novo Token de Integração no painel da Braip e atualize em Atualizar credenciais.
Nenhuma venda chega após horasConfira se a URL colada no postback da Braip está completa (sem espaços) e se os eventos recomendados estão marcados.
”Token inválido” ao ativar o webhookA chave de validação colada no Synchro Hub precisa ser idêntica à cadastrada no postback da Braip — confira maiúsculas, minúsculas e espaços.
Vendas antigas não aparecemPostbacks só enviam eventos novos. Use a funcionalidade de Importação de Histórico (em breve) para backfill.

Perguntas frequentes

Tenho vários produtos na mesma conta Braip. Preciso integrar cada um? Não. A integração é feita pela conta (Token de Integração). Todos os produtos daquela conta enviam eventos para o mesmo postback.

Posso reprocessar vendas antigas? A Braip permite reenvio manual de postbacks pela tela de Histórico de Postbacks. Alternativamente, aguarde a funcionalidade de importação de histórico no Synchro Hub (desde que seu plano contemple importação retroativa).

Como desconecto a integração? No card da Braip, clique em Remover. Os dados serão apagados da Synchro Hub. Lembre-se de remover também o postback no painel da Braip para evitar tentativas de entrega sem destino.