Icaro

Icaro

Última atualização em Aug 16, 2026

PagBank — Integração de Pagamentos

Conecte seu checkout ao PagBank para centralizar cartão, boleto e Pix, tratando notificações automaticamente.

Como funciona a integração?

Esta integração utiliza OAuth (conexão direta). Você conecta sua conta PagBank clicando em um botão e o sistema gerencia a autorização e as notificações. Isso elimina a necessidade de copiar e colar tokens manualmente e garante maior segurança.

Nota: Quando ativo, o status dos pedidos é atualizado automaticamente (ex: de "Pendente" para "Pago") conforme o retorno do banco.

1 - Atenção e Segurança

  • Conexão: Desconectar o módulo interrompe imediatamente o fluxo automático. Trate essa conexão como uma credencial de conta sensível.
  • Parcelamento: O checkout transparente exige que você configure o limite máximo de parcelas. Ajuste isso conforme sua política comercial.
  • Webhooks: As notificações são configuradas automaticamente. Apenas certifique-se de que não há bloqueios de rede no seu servidor que impeçam a entrega.

2 - Passo a Passo de Configuração

  1. Acesso: Vá na lista de formas de pagamento e clique no módulo PagBank.
  2. Conectar: Clique no botão Conectar PagBank. Siga as instruções na janela de autorização externa para vincular sua conta.
  3. Regras de Preço: Defina descontos para pagamento à vista, acréscimos e valores mínimos ou máximos para aceitar pedidos.
  4. Parcelamento: Configure o número máximo de parcelas e a quantidade de parcelas sem juros que você deseja oferecer.
  5. Ativar e Testar: Salve as configurações. Faça uma transação de teste para confirmar que o pagamento está sendo processado e o status atualizado.

3 - Seções de Configuração

  • Conexão (OAuth) Área com os botões para Conectar ou Desconectar sua conta PagBank. Mostra o status atual do vínculo.
  • Regras e Taxas Campos para aplicar descontos automáticos ou taxas extras sobre o valor do pedido ao selecionar este método.
  • Apresentação e Parcelas Personalize o título exibido no checkout (ex: "Cartão de Crédito") e as regras de parcelamento.
  • Webhooks Bloco informativo confirmando que o gerenciamento de notificações é automático pelo sistema.

Dica: Se houver problemas com notificações de pagamento, verifique primeiro se a conta consta como "Conectada" na tela e se não há bloqueios de rede.