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.

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