Flujo aceptador
La interoperabilidad de Código QR permite que billeteras digitales externas procesen pagos con tarjeta de crédito en códigos QR generados por Mercado Pago. En el flujo aceptador, los usuarios de la billetera externa escanean un Código QR de Mercado Pago para completar un pago con tarjeta de crédito directamente desde su billetera.
Este flujo está disponible exclusivamente en Argentina (MLA), aplica únicamente a pagos con tarjeta de crédito, y requiere incorporación previa al programa de interoperabilidad de Mercado Pago.
Cómo funciona
Para integrar el flujo aceptador, sigue estos pasos:
- Crea una aplicación y contacta al Soporte para solicitar la incorporación al programa.
- Obtén las credenciales OAuth y configura las notificaciones de webhook.
- Conecta los endpoints de pago a la API de Mercado Pago.
- Realiza las pruebas de homologación y sube a producción.
El siguiente diagrama ilustra la secuencia de llamadas entre la billetera externa y Mercado Pago:
sequenceDiagram
participant B as Billetera externa
participant MP as Mercado Pago
B->>MP: POST /oauth/token
MP-->>B: access_token (válido 6 h)
B->>MP: GET /resolve?data={qr_raw}
MP-->>B: order_id, métodos de pago
B->>MP: PATCH /orders/{order_id}/plans
MP-->>B: planes de cuotas disponibles
B->>MP: POST /orders/{order_id}/payments
MP-->>B: payment_id, status
B->>MP: GET /payments/{payment_id}
MP-->>B: status del pago
MP->>B: Webhook de notificación del resultado
Requisitos previos
Antes de comenzar la integración, completa los siguientes pasos:
| Requisito | Descripción |
| Cuenta empresa en Mercado Pago | Registra una cuenta con los datos de tu billetera digital. |
| Aplicación registrada | Crea una aplicación en Tus integraciones con solución "Pagos presenciales" y producto "Código QR". |
| Incorporación aprobada | Contacta al Centro de Soporte con identifier, application_id y user_business_id. |
| Credenciales OAuth | Obtén el Client ID y Client Secret desde "Credenciales de producción" en tu aplicación. |
| URL de webhook configurada | Registra tu URL de notificación para el evento "Pagos (interoperabilidad de tarjetas de crédito)" en Notificaciones > Webhooks. |
