MP
Mercado Pago
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
- Crie uma aplicação no Mercado Pago Developers e pegue Client ID e Client Secret.
- Configure os secrets do Worker:
MERCADOPAGO_CLIENT_ID,MERCADOPAGO_CLIENT_SECRETeMERCADOPAGO_WEBHOOK_SECRET(a chave secreta da assinatura do webhook da aplicação). - Redirect URI / webhook na aplicação MP:
https://indicasaas.com/oauth/mercadopago/callbackehttps://indicasaas.com/webhooks/mercadopago. - 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ópico | O que faz |
|---|---|
payment | pagamento aprovado → conversão/comissão |
subscription_authorized_payment | cobrança recorrente da assinatura |
subscription_preapproval | criação/cancelamento da assinatura |
A assinatura do webhook é o header
x-signature (ts + v1), verificada com o MERCADOPAGO_WEBHOOK_SECRET.