Saltar al contenido principal

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​

  1. Pedir el checkout con provider: "mercadopago_checkout_pro" (o auto).
  2. Redirigir el navegador a checkout.url (checkout.method es GET y no hay fields).
  3. En tu return_url leer payment_intent_id y status solo para mostrar un mensaje. El estado definitivo llega por webhook o por GET /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 status del retorno puede ser todavía REQUIRES_ACTION o PROCESSING.
  • 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 PROCESSING y recibes payment.processing; el resultado final llega después con otro evento.

Estados que verás​

SituaciónEstado del intentEvento
Checkout pedidoREQUIRES_ACTIONpayment.checkout.started
Pago en proceso en Mercado PagoPROCESSINGpayment.processing
AprobadoAUTHORIZEDpayment.authorized
RechazadoFAILEDpayment.failed
CanceladoCANCELLEDpayment.cancelled
VencidoEXPIREDpayment.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.