Repository navigation
Adicionar o gateway Mercado Pago #74
Description
Parte da v2.0.0. Depende de #72.
Adicionar o Mercado Pago como terceiro gateway. É o de maior alcance no Brasil junto com o PagBank, e o mais procurado por quem integra e-commerce e PME.
Capacidades
Declara 3 das 5 — e é justamente por isso que #72 vem antes:
| Capacidade | Declara? | Motivo |
|---|---|---|
SupportsCustomers |
✅ | /v1/customers |
SupportsCharges |
✅ | /v1/payments |
SupportsSubscriptions |
✅ | /preapproval |
SupportsWebhooks |
❌ | Não há CRUD por API: configura-se no painel "Suas integrações", ou por pagamento via notification_url |
SupportsPixKeys |
❌ | Pix é forma de pagamento da cobrança (payment_method_id: "pix"), não recurso com chaves |
Particularidades a tratar
- Idempotência:
POST /v1/paymentsexige o headerX-Idempotency-Key. OHasHttpClientprecisa aceitar headers por requisição. - Ambiente: o Mercado Pago não tem URL de sandbox. O ambiente é definido pelo prefixo do access token (
TEST-), então o parâmetro$sandboxdos outros gateways não se aplica. - Cliente não é pré-requisito de cobrança: diferente do Asaas, o pagamento carrega
payer.emaildireto./v1/customersserve a cartões salvos, não ao fluxo de cobrança. - Sem exclusão de cliente: a API não expõe delete.
Escopo
Gateway, trait de client, recursos Customer, Charge e Subscription, validadores, enum de forma de pagamento, testes com HTTP mockado e exemplos.
Activity