MP

Mercado Pago

OAuth · Pix, boleto e cartão

Conexão via OAuth. Pix, boleto e cartão. O webhook do MP é "magro" (só id + tópico) — buscamos o recurso completo na API com o token da sua conta.

Conectar

  1. Crie uma aplicação no Mercado Pago Developers e pegue Client ID e Client Secret.
  2. Configure os secrets do Worker: MERCADOPAGO_CLIENT_ID, MERCADOPAGO_CLIENT_SECRET e MERCADOPAGO_WEBHOOK_SECRET (a chave secreta da assinatura do webhook da aplicação).
  3. Redirect URI / webhook na aplicação MP: https://indicasaas.com/oauth/mercadopago/callback e https://indicasaas.com/webhooks/mercadopago.
  4. No painel → Gateways → Mercado Pago → Conectar → autorize (OAuth com PKCE).

Passe o ref no checkout

O valor do ref é o click_id que o afs.js persistiu (AFS.getRef()). Anexe-o no external_reference da preferência/pagamento ao criar a cobrança. O external_reference propaga para as cobranças da assinatura.

// Ao criar a preferência/assinatura no Mercado Pago:
{
  // ...
  "external_reference": ref,         // AFS.getRef()
  "metadata": { "aff_ref": ref }     // fallback
}

Eventos (tópicos)

TópicoO que faz
paymentpagamento aprovado → conversão/comissão
subscription_authorized_paymentcobrança recorrente da assinatura
subscription_preapprovalcriação/cancelamento da assinatura
A assinatura do webhook é o header x-signature (ts + v1), verificada com o MERCADOPAGO_WEBHOOK_SECRET.