PagBank
Conecte a sua conta PagBank com um token. O aviso de pagamento vai em cada pedido, sem configuração.
O PagBank recebe Pix, boleto e cartão pela API de Pedidos. Basta um token da sua conta. O dinheiro cai direto na sua conta PagBank.
O que você vai precisar
| Campo no painel | Onde encontrar | Obrigatório |
|---|---|---|
| Token | Produção: na sua conta PagBank, em Venda online › Integrações. Sandbox: no Portal do Desenvolvedor do PagBank. | Sim |
| Número do estabelecimento (EDI) | Liberado pelo PagBank junto com o acesso à API de Extrato EDI. | Não |
| Token do Extrato EDI | Liberado pelo PagBank junto com o acesso à API de Extrato EDI. | Não |
Os campos do Extrato EDI só servem para importar vendas antigas. Sem eles, a conexão vende normalmente.
Passo a passo
Gere o token
- Produção: na sua conta PagBank, abra Venda online › Integrações e gere um token.
- Sandbox: use o token do ambiente de testes, gerado no Portal do Desenvolvedor do PagBank.
Peça o Extrato EDI (opcional)
Se você quer ver na MinePag as vendas antigas da conta, peça ao PagBank o acesso à API de Extrato EDI. Ele informa o número do estabelecimento e o token EDI. O Extrato EDI só existe em Produção.
Conecte na MinePag
- No painel da loja, abra Configurações › Gateways e clique em Conectar no cartão do PagBank.
- Escolha Produção ou Sandbox e, se quiser, dê um nome à conexão. Clique em Continuar.
- Cole o Token e, se tiver, o Número do estabelecimento (EDI) e o Token do Extrato EDI. Clique em Continuar.
- Se você informou o Extrato EDI em Produção, escolha o período de importação. Clique em Conectar PagBank.
Ao final, o painel mostra: "O PagBank avisa a MinePag em cada pedido. Não há nada para configurar."
Avisos de pagamento
O PagBank não tem um cadastro fixo de webhook. A MinePag envia o endereço de aviso em cada pedido criado, e o PagBank avisa nesse endereço quando o pagamento muda. Os avisos são conferidos pela assinatura do PagBank, e a MinePag consulta o pedido na API antes de confirmar. Veja Webhooks dos gateways.
Cartão
No checkout, o cartão é criptografado no navegador do cliente com a chave pública da sua conta PagBank, obtida pela MinePag ao validar o token. A MinePag recebe só o cartão criptografado, nunca o número ou o código de segurança.
Reembolsos
| Forma | Reembolso pela MinePag |
|---|---|
| Pix | Total ou parcial. |
| Cartão | Total ou parcial. |
| Boleto | Não é possível pela API. Devolva o valor ao cliente por fora. |
Veja Reembolsos e contestações.
Importação de histórico
A API de Pedidos do PagBank não lista vendas antigas. A importação só funciona com as credenciais do Extrato EDI, em Produção:
- Sem o Extrato EDI, a página da conexão mostra "Informe as credenciais do Extrato EDI (em Produção) para importar vendas antigas do PagBank." As vendas feitas pela MinePag aparecem em Vendas › Transações normalmente.
- O extrato de um dia só fica completo no dia seguinte. As vendas de hoje entram na sincronização de amanhã.
Para incluir o Extrato EDI depois de conectar, preencha os dois campos em Atualizar credenciais na página da conexão. Veja Importação de histórico.
Mensagens de erro
| Mensagem | Como resolver |
|---|---|
| O PagBank recusou o token. Gere um token de produção na área de integrações da sua conta. | Gere um token novo em Venda online › Integrações e cole de novo. |
| O PagBank recusou o token. Use o token do ambiente de testes (Sandbox), gerado no portal do desenvolvedor. | Para Sandbox, o token de produção não funciona. Use o do Portal do Desenvolvedor. |
| O PagBank recusou as credenciais do Extrato EDI. | Confira o número do estabelecimento e o token EDI com o PagBank, ou deixe os dois em branco. |
Mais casos em Problemas comuns.