Integração com o PagSeguro
Siga o passo a passo abaixo para solicitar a liberação da integração junto ao suporte do PagSeguro, gerar o token e configurar o webhook que confirma os pagamentos automaticamente no seu painel Mandaê.
Solicite a liberação da integração no suporte do PagSeguro
Diferente do Mercado Pago, o PagSeguro não libera a integração via API automaticamente. É necessário entrar em contato com o suporte do PagSeguro e solicitar a liberação da integração para o seu estabelecimento antes de qualquer outra etapa.
- Acesse sua conta em minhaconta.pagbank.com.br (ou o app PagBank).
- Vá até Central de Ajuda / Suporte e abra um atendimento (chat ou telefone) falando com um atendente humano.
- Informe que deseja liberar a integração via API/Webhook para receber pagamentos (Pix e cartão) no seu sistema de delivery.
- Tenha em mãos o CNPJ ou CPF da conta, e-mail cadastrado e o nome do sistema (Mandaê).
Essa etapa é obrigatória. Sem essa liberação feita pelo suporte do PagSeguro, o token gerado pode não funcionar para receber notificações de pagamento (webhook).
Gere o token de integração
Depois que o suporte confirmar a liberação, acesse a área de integrações da sua conta para gerar o token de acesso.
- Entre em minhaconta.pagbank.com.br → Vender online → Integrações (ou "Minhas aplicações", conforme o menu disponível na sua conta).
- Gere um novo Token de integração e copie o valor exibido — ele só aparece uma vez.
- Cole o token no painel do Mandaê, em Configurações → Pagamentos → PagSeguro, junto com o e-mail da conta PagSeguro.
- Salve as alterações para ativar o PagSeguro no seu checkout.
Guarde o token em local seguro. Se ele for perdido ou exposto, gere um novo pelo painel do PagSeguro e atualize no Mandaê.
Configure o Webhook (notificações de pagamento)
O webhook é o endereço que o PagSeguro chama automaticamente sempre que o status de um pagamento mudar (pago, pendente, cancelado). É assim que o Mandaê confirma o pedido sem depender de atualização manual.
- Na área de integrações da sua conta PagSeguro, procure o campo URL de notificação (Notification URL) — se não encontrar essa opção, peça ao suporte para configurá-la para você, junto com a liberação do passo 1.
- Informe o endereço abaixo como URL de notificação.
- Confirme que os eventos de Pix e Pagamento (Transação) estão marcados para envio de notificação.
Se o suporte do PagSeguro pedir para confirmar o endereço do webhook por e-mail ou chamado, envie exatamente essa URL.
Teste a integração
Antes de liberar para os clientes, gere um pagamento de teste no seu próprio cardápio para validar todo o fluxo.
- Faça um pedido de teste no seu cardápio e escolha pagamento via PagSeguro (Pix ou cartão).
- Finalize o pagamento (pode ser um valor baixo, ex: R$1,00).
- Confira se o pedido muda automaticamente para "Pago" no painel do Mandaê em poucos segundos.
- Se o status não atualizar, confirme com o suporte do PagSeguro se a URL do webhook foi realmente ativada na sua conta, e revise o token no painel do Mandaê.