Para que a tokenização na bandeira funcione, a Rede precisa saber para qual URL enviar o evento PV.TOKENIZACAO-BANDEIRA quando o processamento do token for concluído. Sem esse cadastro, a Bempaggo nunca recebe a confirmação da Rede — e o token fica preso em PENDING para sempre.
Para quem é esta páginaEsta configuração é feita uma vez por empresa (CNPJ) no portal da Rede. Ela é necessária independentemente de quantos sellers (PVs) a sua empresa tiver cadastrados.
Por que esse cadastro é necessário
O fluxo de tokenização na bandeira envolve três partes: você (integrador), a Bempaggo e a Rede. O processamento do token na Rede é assíncrono — a Rede notifica a Bempaggo quando termina, e a Bempaggo repassa o resultado para você.
Rede ──── POST ────► URL cadastrada no portal Rede
│
▼
Bempaggo processa e notifica sua notificationUrlSem a URL cadastrada, a Rede não entrega o evento e a Bempaggo não chega a processar o resultado.
Qual URL cadastrar
Use a URL correspondente ao ambiente:
| Ambiente | URL |
|---|---|
| Produção | https://api.bempaggo.io/api/v2/webhooks/rede/companies/{companyId}/network-token |
| Sandbox | https://api-sandbox.bempaggo.io/api/v2/webhooks/rede/companies/{companyId}/network-token |
Substitua {companyId} pelo ID da sua empresa na Bempaggo (não é o sellerId). Em caso de dúvida sobre qual é o seu companyId, entre em contato com o suporte da Bempaggo.
Exemplo (produção):
https://api.bempaggo.io/api/v2/webhooks/rede/companies/17/network-tokenComo cadastrar no portal da Rede
Acesse o portal userede.com.br com suas credenciais de estabelecimento e siga o caminho:
Vender Online → e-Commerce → Tokenização de Bandeira → Cadastro de URL
Passo a passo
1. Acesse o menu Vender Online no painel principal.
2. Clique em e-Commerce e depois em Tokenização de Bandeira.
3. Na seção Cadastro de URL, informe a URL da Bempaggo correspondente ao ambiente (produção ou sandbox).
4. Escolha o tipo de autenticação (veja a seção abaixo).
5. Salve o cadastro.
AtençãoA URL cadastrada é utilizada para todos os PVs (estabelecimentos) vinculados ao mesmo CNPJ. Verifique se a URL e o
companyIdestão corretos antes de salvar — a Rede não se responsabiliza pelo cadastro de URLs inválidas.
Autenticação da URL
A Rede pergunta no momento do cadastro se a URL possui autenticação ou não.
Sem autenticação
A Rede entrega o evento diretamente, sem incluir credenciais no header. O endpoint da Bempaggo é público e aceita esse modo.
Com autenticação — Basic
Informe o usuário e senha no portal da Rede. A Rede incluirá o header Authorization: Basic <base64> em cada requisição.
Com autenticação — Bearer
Informe o token no portal da Rede. A Rede incluirá o header Authorization: Bearer <token> em cada requisição.
RecomendaçãoPara produção, prefira autenticação Bearer ou Basic. Isso garante que apenas a Rede consiga entregar eventos no endpoint da Bempaggo.
Verificando se o cadastro funcionou
Após o cadastro, faça uma solicitação de tokenização via API:
POST https://api-sandbox.bempaggo.io/api/v2/sellers/{sellerId}/cards/tokens/networkAguarde alguns minutos (no sandbox pode levar até ~4 min) e consulte o status do token:
GET https://api-sandbox.bempaggo.io/api/v2/sellers/{sellerId}/cards/tokens/network/{token}Se o status passar de PENDING para ACTIVE ou FAILED, o cadastro da URL está correto e o fluxo está funcionando.
Se o token permanecer em PENDING indefinidamente, revise a URL cadastrada no portal (verifique o companyId e o ambiente correto).
Perguntas frequentes
Preciso cadastrar uma URL diferente para sandbox e produção?
Sim. Sandbox e produção são ambientes separados. Cadastre a URL de sandbox no portal de testes da Rede e a URL de produção no portal de produção.
A URL muda se eu adicionar novos sellers (PVs)?
Não. A URL é única por CNPJ e cobre todos os PVs. Você não precisa recadastrar ao adicionar novos sellers.
O que acontece se eu mudar a URL no portal da Rede?
Eventos gerados após a mudança passam a ser entregues na nova URL. Tokenizações em andamento com a URL antiga podem não ser entregues — use o endpoint de consulta para verificar o status de tokens que ficaram em PENDING.
Posso usar a mesma URL para sandbox e produção?
Não é recomendado. Misturar ambientes pode gerar inconsistências nos dados. Use a URL de sandbox para testes e a URL de produção exclusivamente em produção.