Flujo con Mercado Pago Checkout Pro
Con Mercado Pago la plataforma crea una orden de Checkout Pro y te devuelve su URL de checkout
para redirigir al comprador por GET. El resultado lo informa Mercado Pago por webhook a la
plataforma, que consulta la orden para confirmarlo antes de avisarte.
Qué tienes que hacer
- Pedir el checkout con
provider: "mercadopago_checkout_pro"(oauto). - Redirigir el navegador a
checkout.url(checkout.methodesGETy no hayfields). - En tu
return_urlleerpayment_intent_idystatussolo para mostrar un mensaje. El estado definitivo llega por webhook o porGET /v1/payment-intents/{id}.
Detalles que importan
- El retorno es solo experiencia de usuario. El comprador puede volver antes de que Mercado Pago
notifique el pago: el
statusdel retorno puede ser todavíaREQUIRES_ACTIONoPROCESSING. - La plataforma verifica y reconfirma. Cada aviso de Mercado Pago se valida con su firma, se registra y se contrasta consultando la orden. Un aviso repetido o tardío no produce un segundo efecto.
- Pagos en revisión. Si Mercado Pago deja el pago en proceso, el intent queda en
PROCESSINGy recibespayment.processing; el resultado final llega después con otro evento.
Estados que verás
| Situación | Estado del intent | Evento |
|---|---|---|
| Checkout pedido | REQUIRES_ACTION | payment.checkout.started |
| Pago en proceso en Mercado Pago | PROCESSING | payment.processing |
| Aprobado | AUTHORIZED | payment.authorized |
| Rechazado | FAILED | payment.failed |
| Cancelado | CANCELLED | payment.cancelled |
| Vencido | EXPIRED | payment.expired |
Ambientes
Igual que Webpay: MOCK (simulador), SANDBOX (credenciales de prueba de Mercado Pago) o
PRODUCTION, según la configuración del comercio. Tu integración no cambia.