Integração com o Mercado Pago (Pix)
Siga o passo a passo abaixo para conectar sua conta do Mercado Pago ao Mandaê, gerar o Access Token e configurar o webhook que confirma os pagamentos via Pix automaticamente no seu painel.
Crie ou acesse sua conta no Mercado Pago Developers
Acesse o painel de desenvolvedores do Mercado Pago com a mesma conta usada para receber os pagamentos do seu estabelecimento.
- Acesse developers.mercadopago.com.br e faça login com sua conta Mercado Pago.
- No menu lateral, entre em Suas integrações.
- Clique em Criar aplicação, dê um nome (ex: "Mandaê Delivery") e selecione a opção de pagamentos online / Checkout Transparente com Pix.
Use uma conta Mercado Pago verificada e com dados bancários já cadastrados, para evitar bloqueios na hora de receber os pagamentos.
Pegue o Access Token (Credenciais de Produção)
Dentro da aplicação criada, vá até a aba Credenciais de produção. É esse token que o Mandaê usa para gerar as cobranças Pix e consultar o status dos pagamentos.
- Copie o Public Key e o Access Token exibidos na tela.
- Cole essas informações no painel do Mandaê, em Configurações → Pagamentos → Mercado Pago.
- Salve as alterações para ativar o Pix no seu checkout.
Nunca compartilhe seu Access Token publicamente. Se ele for exposto, gere um novo token imediatamente pelo painel do Mercado Pago.
Configure o Webhook (notificações de pagamento)
O webhook é o endereço que o Mercado Pago vai chamar automaticamente sempre que o status de um pagamento Pix mudar (pago, pendente, cancelado). É assim que o Mandaê confirma o pedido sem precisar que o cliente atualize a página.
- Ainda na sua aplicação, acesse a aba Webhooks.
- Clique em Configurar notificações.
- Em URL de produção, cole o endereço abaixo.
- Selecione o evento Pagamentos (payments).
- Salve e, se disponível, use o botão de simular para testar o recebimento.
Teste a integração
Antes de liberar para os clientes, gere um Pix 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 Pix.
- Pague o QR Code gerado (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, revise se a URL do webhook foi salva corretamente no Mercado Pago e se o Access Token está correto no Mandaê.