Como integrar sua loja com a PagBrasil para estorno integrado

❓O que a integração faz

Com a integração, você estorna o valor das reversas pagas via PagBrasil direto pela Troquecommerce, sem precisar entrar no painel da PagBrasil.
A PagBrasil é uma empresa de pagamentos: ela processa o cartão, o PIX ou o boleto que o seu cliente usou na compra. Por isso, quando é preciso devolver esse valor, o estorno tem que acontecer na PagBrasil, e não na plataforma da loja.
Com a integração ativa:

• Na hora de reembolsar uma reversa paga pela PagBrasil, aparece o botão Estornar pelo Pagbrasil.
• Com um clique, a Troquecommerce envia o pedido de estorno para a PagBrasil.
• Pedidos pagos por outros meios continuam sendo estornados normalmente, como já acontece hoje.

⚠️Antes de começar

No momento, a integração funciona para lojas que vendem pela Shopify. Se a sua loja usa outra plataforma, fale com o nosso suporte antes de configurar.
Também é necessário ter o aplicativo da PagBrasil instalado e configurado na sua Shopify. É ele que envia para a Troquecommerce a identificação do pedido dentro da PagBrasil, necessária para fazer o estorno.

💡Como solicitar e enviar os dados de acesso

A integração é configurada pelo nosso time. Você só precisa pedir dois dados à PagBrasil e enviá-los para nós.

1. Entre em contato com o atendimento da PagBrasil e solicite o Secret e o PB Token da sua conta.
2. Envie também os Identificadores dos meios de pagamento
3. Envie os dados para o nosso time de suporte, informando o nome da sua loja e que deseja integrar com a PagBrasil.
4. Nosso time faz a configuração da integração na sua loja.

Com a integração ativa, as reversas pagas pela PagBrasil passam a exibir o botão Estornar pelo Pagbrasil no Dashboard, na hora do reembolso.
Atenção: o Secret e o PB Token dão acesso à sua conta PagBrasil. Envie esses dados somente pelo canal oficial de suporte da Troquecommerce e nunca os compartilhe com terceiros.

🪙Como funciona o estorno no dia a dia

Depois de ativar, o atendimento das reversas segue igual. A diferença aparece só no momento do reembolso.

1. O cliente abre a troca ou devolução pela Central de trocas da sua loja.
2. A Troquecommerce reconhece que o pedido foi pago pela PagBrasil.
3. A reversa segue o fluxo normal até a etapa de reembolso.
4. Você clica em Estornar pelo Pagbrasil no Dashboard.

1. A PagBrasil recebe e aceita o pedido de estorno, e a reversa passa para o status Processando Pagamento.
2. Quando a PagBrasil conclui o estorno, o valor volta para o cliente pelo mesmo meio de pagamento usado na compra.

Por que a reversa fica em "Processando Pagamento"? Esse status indica que a PagBrasil aceitou o pedido de estorno, mas o dinheiro ainda pode não ter chegado ao cliente. O prazo de devolução depende da PagBrasil e do meio de pagamento.
E se der erro? Se a PagBrasil recusar o estorno, a mensagem de erro fica registrada na reversa como uma pendência financeira. Nesse caso, faça o estorno manualmente no painel da PagBrasil ou fale com o nosso suporte.

💡Dúvidas frequentes

Preciso desativar o reembolso integrado da minha plataforma? Não. Os pedidos pagos por outros meios continuam sendo estornados pela plataforma da loja, como já acontece hoje.
Quem decide se o estorno vai pela PagBrasil? A forma de pagamento do pedido. Se o nome dela contém o identificador configurado pelo nosso time, o estorno vai pela PagBrasil, independentemente da plataforma em que a venda foi feita.
O cliente recebe o dinheiro na hora? Não necessariamente. A Troquecommerce envia o pedido de estorno e a PagBrasil cuida da devolução. O prazo depende da PagBrasil e do meio de pagamento usado na compra.

Actualizado em: 20/10/2026