Modelo de integración
Checkout API ahora procesa pagos con Orders. Se trata de una API diseñada para simplificar su desarrollo con Mercado Pago: con una única integración, podrá acceder a diversas soluciones de pago.
Además, la API hace que el código de integración sea más intuitivo y proporciona mensajes de error más detallados, facilitando el proceso de desarrollo.
Diferencias en el procesamiento
Anteriormente, los pagos a través de Checkout API eran procesados exclusivamente por la API de Pagos. Ahora, también es posible procesarlos mediante Orders, que ofrece una alternativa eficiente y sencilla para la integración.
Ve a continuación las principales diferencias entre las dos opciones.
| Funcionalidad | API de Pagamentos | API de Orders |
| Procesamiento del pago | Automático (crea y procesa tu transacción). | Automático y manual (eligiendo cuándo procesar la transacción). |
| Transacciones | Una transacción por solicitud. | Múltiples transacciones por solicitud. |
| Operaciones | Pagos online. | Pagos online y Pagos presenciales (Point de Mercado Pago). |
| Notificaciones | Configuración avanzada por notification_url. | Configuración más simple a partir de la sección de Notificaciones en Tus integraciones. |
| Validación de errores | Retorna un error a la vez. | Retorna una lista con todos los errores en la solicitud. |
Modos de procesamiento de Orders
Una order de pagos online puede ser creada para ser procesada de dos modos: Modo automático y Modo manual.
La definición del modo de procesamiento se realizará al momento de crear la order, mediante el parámetro processing_mode. Su valor deberá ser automatic, para procesamientos automáticos, o manual, para procesar la order manualmente.
El modo automático es el modo predeterminado de la aplicación. A través de este, la transacción se completa en una sola etapa y las modificaciones son limitadas. Para crear la order en modo automático, el campo processing_mode, que es responsable de definir el formato de creación y procesamiento de la transacción, vá a estar como automatic y toda la información es enviada en una única solicitud.
Las operaciones permitidas son:
- Crear y procesar order: responsable por la creación de la order y el procesamiento de la transacción en simultáneo.
- Obtener order: permite obtener información sobre un pedido, incluido su status en tiempo real.
- Capturar order: permite capturar el monto autorizado de una order. Esta opción solo es válida para tarjetas de crédito.
- Cancelar order: responsable de la cancelación de una order ya existente, pero que aún no ha sido procesada.
- Reembolsar order: en el caso del modo automático, se puede crear reembolsos totales o parciales de un pago. La order será reembolsada totalmente si todas las transacciones son reembolsadas por completo.
- Reembolso total: no se debe indicar un monto a reembolsar en el
bodyde la solicitud, que debe ir vacío. - Reembolso parcial: se debe especificar la cantidad a reembolsar en el
bodyde la solicitud, junto con el ID de la transacción. Todas las otras transacciones permanecerán como están y solo la transacción modificada será reembolsada.
- Reembolso total: no se debe indicar un monto a reembolsar en el