Introdução ao Pix em Aplicativos Mercado Pago

O Mercado Pago documenta pagamentos nativos com Stripe ou Paddle, e também a conexão com a sua própria conta Stripe. Para pagamentos via Pix, o servidor cria o pagamento e o app apenas exibe o QR Code e o Pix Copia e Cola. A liberação do acesso é confirmada por uma notificação com assinatura validada.

Como receber via Pix num app feito no Lovable/Bolt: Mercado Pago, webhooks e os erros mais comuns

Pré-requisitos e Configurações

Para integrar Pix em aplicativos Mercado Pago, é necessário uma conta de vendedor com chaves Pix cadastradas e uma aplicação em Suas integrações com a public key e o access token de teste. O backend é geralmente implementado no Supabase, onde as Edge Functions são armazenadas.

Criando o Pagamento Pix

O Mercado Pago documenta o Pix como um POST em /v1/payments com payment_method_id: "pix", incluindo o e-mail do comprador e o cabeçalho obrigatório X-Idempotency-Key para evitar cobranças duplicadas. O valor do pagamento também é definido no servidor, não no corpo do pedido.

Exibindo QR Code e Copia e Cola

A resposta do servidor chega com status pending e traz três campos úteis: qr_code_base64 (a imagem do QR Code), qr_code (o texto do Pix Copia e Cola) e ticket_url (uma página do Mercado Pago para confirmar o pagamento). O Pix é pago fora do seu app, no banco do comprador.

Validando Assinatura de Webhook

Para garantir a autenticidade das notificações, é necessário configurar uma URL de webhook na criação do pagamento e validar o cabeçalho x-signature. O Mercado Pago não envia um JWT do Supabase, então é necessário configurar a função de validação de assinatura.

Resposta 200 e Webhooks

Quando a notificação chega, a função de webhook deve responder com 200 em até 22 segundos, tratando a notificação como um sinal de pagamento confirmado.

Conclusão

Compreendendo os fluxos e webhooks do Mercado Pago é crucial para uma integração Pix eficiente e segura em aplicativos. É essencial seguir as melhores práticas para garantir a confiabilidade e a integridade dos pagamentos.

Comentários