Integrar el procesamiento de pagos
El procesamiento de pagos con Mercado Pago Point se basa en la creación de orders asociadas a una transacción de pago. Estas orders permiten que tu sistema inicie y acompañe cada cobro procesado en la terminal, lo relacione con la operación correspondiente mediante external_reference y mantenga actualizada su conciliación a partir de los cambios de estado.
En el modo PDV, el vendedor crea una order y esta se envía automáticamente a la terminal Point indicada para que el comprador realice el pago.
En el modo SELF_SERVICE, la order se procesa en tiempo real entre el tótem utilizado por el comprador y Mercado Pago, sin intervención manual. En este modo, la terminal queda dedicada al procesamiento de pagos, con acceso restringido a configuraciones y funcionalidades avanzadas.
El procesamiento de pagos integrado con Mercado Pago Point te permitirá crear orders, procesarlas, cancelarlas o bien realizar reembolsos y consultar su información o actualizaciones de estado.
Para comenzar a procesar pagos con Point desde los puntos de venta, primero necesitas identificar a qué terminal deseas asignar la order.
Recuerda que la terminal debe estar configurada en modo PDV o SELF_SERVICE.
Para eso, envía una solicitud al endpoint Obtener terminalsGET, utilizando tu Access Token de pruebaClave privada vinculada a una aplicación, utilizada en el backend para autenticar operaciones en el entorno de prueba. Puedes consultarla en la sección Credenciales de la aplicación, dentro del entorno de prueba. No permite procesar pagos reales, nunca debe exponerse en el frontend y comienza con el prefijo `APP_USR`.Acceder a las credenciales de prueba.
Si es necesario, puedes filtrar la búsqueda utilizando los query params opcionales store_id y pos_id, que corresponden a los identificadores de la tienda y la caja devueltos en la respuesta a la creación de cada uno.
curlcurl -X GET \ 'https://api.mercadopago.com/terminals/v1/list?limit=50&offset=0&store_id=12354567&pos_id=23545678' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}'
La respuesta a esta solicitud mostrará las terminals asociadas a tu cuenta, lo que te permitirá seleccionar la que deseas usar para crear tu order.
La terminal puede identificarse por los últimos caracteres del campo id, que corresponden al número de serie impreso en la etiqueta trasera de la terminal física.
json{ "data": { "terminals": [ { "id": "NEWLAND_N950__N950NCB801293324", "pos_id": "23545678", "store_id": "12354567", "external_pos_id": "SUC0101POS", "operating_mode": "PDV | SELF_SERVICE" } ] }, "paging": { "total": 1, "offset": 0, "limit": 50 } }
Luego, deberás crear la order. Para eso, envía una solicitud al endpoint /v1/ordersPOST, cuidando de incluir tu Access Token de pruebaClave privada vinculada a una aplicación, utilizada en el backend para autenticar operaciones en el entorno de prueba. Puedes consultarla en la sección Credenciales de la aplicación, dentro del entorno de prueba. No permite procesar pagos reales, nunca debe exponerse en el frontend y comienza con el prefijo `APP_USR`.Acceder a las credenciales de prueba, y el ID de la terminal a la que quieres asignar la order, obtenido en el paso anterior.
La misma solicitud de creación se utiliza para los modos PDV y SELF_SERVICE. En el modo SELF_SERVICE, puedes definir cuánto tiempo permanecerá disponible cada pantalla mediante el parámetro opcional config.point.screen_time. En el modo PDV, config.point.screen_time no aplica.
curlcurl -X POST \ 'https://api.mercadopago.com/v1/orders' \ -H 'Content-Type: application/json' \ -H 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \ -H 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \ -d '{ "type": "point", "external_reference": "ext_ref_1234", "expiration_time": "PT16M", "transactions": { "payments": [ { "amount": "24.00" } ] }, "config": { "point": { "terminal_id": "NEWLAND_N950__N950NCB801293324", "print_on_terminal": "no_ticket" } }, "description": "Point Smart 2", "integration_data": { "platform_id": "dev_1234567890", "integrator_id": "dev_1234567890", "sponsor": { "id": "446566691" } } }'
Consulta en la tabla a continuación las descripciones de los parámetros que tienen alguna particularidad importante que debe destacarse.
| Atributo | Tipo | Descripción | Obligatoriedad |
Authorization | Header | Hace referencia a tu Access Token de pruebaClave privada vinculada a una aplicación, utilizada en el backend para autenticar operaciones en el entorno de prueba. Puedes consultarla en la sección Credenciales de la aplicación, dentro del entorno de prueba. No permite procesar pagos reales, nunca debe exponerse en el frontend y comienza con el prefijo `APP_USR`.Acceder a las credenciales de prueba. | Requerido |
X-Idempotency-Key | Header | Llave de idempotencia. Esta llave garantiza que cada solicitud sea procesada una única vez, evitando duplicidades. Utiliza un valor exclusivo en el encabezado de tu solicitud, como un UUID V4 o strings aleatorias. | Requerido |
type | Body.String | Tipo de order, asociado a la solución de Mercado Pago para la que se crea. Para pagos con Mercado Pago Point, el único valor posible es point. | Requerido |
external_reference | Body.String | Es una referencia externa de la order, asignada al momento de su creación. Debe ser un valor único para cada order y no puede contener datos PII. El límite máximo permitido es de 64 caracteres. Se permiten letras mayúsculas y minúsculas, números, guiones (-) y guiones bajos (_). | Requerido |
expiration_time | Body.String | Indica el período de validez de la order. El valor mínimo permitido es 30 segundos (PT30S) y el máximo es 3 horas (PT3H). | Opcional |
transactions.payments.amount | Body.String | Monto total de la order de pago. Admite hasta 2 decimales y el separador decimal es opcional. Ejemplos válidos: 10, 10.5 y 10.00. | Requerido |
config.point.screen_time | Body.String | Disponible únicamente en el modo SELF_SERVICE. Define, en formato ISO 8601, durante cuánto tiempo las pantallas de la terminal permanecen disponibles para procesar la order. Admite entre 5 segundos (PT5S) y 5 minutos (PT5M); si se omite, utiliza 15 segundos (PT15S). El tiempo se reinicia cuando cambia la pantalla o el usuario interactúa con la terminal. Si la order no se procesa en ese lapso, se cancela. La pantalla de lectura de la tarjeta se muestra durante un máximo de 60 segundos, aunque se configure un valor superior. | Opcional |
config.point.terminal_id | Body.String | Identificador de la terminal Point que recibirá la order. Debes enviarlo tal como fue devuelto en la solicitud Obtener terminalsGET. | Requerido |
config.point.print_on_terminal | Body.String | Define si la terminal imprime el comprobante de la transacción. En el modo PDV, admite seller_ticket —valor predeterminado— o no_ticket. En el modo SELF_SERVICE, admite seller_ticket, no_ticket o buyer_ticket —valor predeterminado—. | Opcional |
processing_mode | Body.String | Modo de procesamiento de la order. Si no envías este parámetro, la order se procesa en modo automatic. En modo PDV, también puedes enviar manual para crear una order en modo reserva de pago. | Opcional |
config.payment_method.default_type | Body.String | Indica el medio de pago que aceptará la terminal. Por defecto, acepta todos los medios de pago disponibles. | Opcional |
Si la solicitud fue exitosa, la respuesta devolverá una order con estado created.
json{ "id": "ORD00001111222233334444555566", "type": "point", "user_id": "5238400195", "external_reference": "ext_ref_1234", "description": "Point Smart 2", "expiration_time": "PT16M", "processing_mode": "automatic", "country_code": "MEX", "currency": "MXN", "integration_data": { "application_id": "1234567890", "platform_id": "dev_1234567890", "integrator_id": "dev_1234567890", "sponsor": { "id": "446566691" } }, "status": "created", "status_detail": "created", "created_date": "2024-09-10T14:26:42.109320977Z", "last_updated_date": "2024-09-10T14:26:42.109320977Z", "config": { "point": { "terminal_id": "NEWLAND_N950__N950NCB801293324", "print_on_terminal": "no_ticket" }, "payment_method": { "default_type": "credit_card" } }, "transactions": { "payments": [ { "id": "PAY01J67CQQH5904WDBVZEM4JMEP3", "amount": "24.00", "status": "created" } ] } }
order_id) y el ID del pago (transactions.payments.id) obtenidos al crearla, y relaciónalos con external_reference. Estos datos te permitirán realizar otras operaciones, consultar tus notificaciones y mantener la conciliación con tu sistema. Además, puedes consultar nuestra documentación en la sección Recursos para conocer los posibles status de una order y de una transacción.Una vez creada, la order será enviada a la terminal asignada.
En el modo PDV, si la order no se carga automáticamente, presiona el botón Actualizar o, si la terminal lo tiene, el botón verde para recibirla. Si no completas el parámetro expiration_time, la order expirará 15 minutos después de su creación.
En el modo SELF_SERVICE, la order se procesa sin intervención manual. Si no completas el parámetro expiration_time, la order expirará 15 segundos después de su creación. Si el comprobante de pago se imprime desde el tótem, envía no_ticket en config.point.print_on_terminal para evitar su impresión en la terminal Point.
El modo reserva de pago está disponible únicamente para terminales configuradas en modo PDV.
Además, para crear orders en modo de reserva, el único medio de pago compatible es tarjeta de crédito (
default_type=credit_card).Luego de localizar las terminals asociadas a tu cuenta y definir en cuál se creará la order, puedes crear la order en modo reserva.
El modo reserva permite separar la autorización del débito: los fondos quedan retenidos en la tarjeta del comprador y se capturan de forma independiente cuando el monto final queda definido. Es útil en hospedajes, alquileres o cualquier escenario donde el monto puede variar respecto del monto pre-autorizado.
Para activar el modo reserva, envía una solicitud al endpoint /v1/ordersPOST, cuidando de incluir tu Access Token de pruebaClave privada vinculada a una aplicación, utilizada en el backend para autenticar operaciones en el entorno de prueba. Puedes consultarla en la sección Credenciales de la aplicación, dentro del entorno de prueba. No permite procesar pagos reales, nunca debe exponerse en el frontend y comienza con el prefijo `APP_USR`.Acceder a las credenciales de prueba, el id de la terminal a la que quieres asignar la order, obtenido en el paso anterior, e incluye processing_mode=manual.
expiration_time, la order expirará automáticamente después de 3 minutos. Si envías un valor superior a 3 minutos, la API devolverá el error 400 - invalid_expiration_time y la order no será creada. Este plazo predeterminado evita que un intento quede pendiente cuando la terminal no admite el flujo de reserva. En la creación de orders en modo automático (predeterminado), el plazo predeterminado permanece en 15 minutos.
curlcurl -X POST \ 'https://api.mercadopago.com/v1/orders' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \ --header 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \ --data '{ "type": "point", "processing_mode": "manual", "external_reference": "ext_ref_1234", "description": "Reserva de hospedaje", "expiration_time": "PT2M", "transactions": { "payments": [ { "amount": "1500.00" } ] }, "config": { "point": { "terminal_id": "PAX_A910__SMARTPOS123456789" }, "payment_method": { "default_type": "credit_card" } } }'
Consulta en la tabla a continuación las descripciones de los parámetros que tienen alguna particularidad importante que debe destacarse.
| Atributo | Tipo | Descripción | Obligatoriedad |
Authorization | Header | Hace referencia a tu Access Token de pruebaClave privada vinculada a una aplicación, utilizada en el backend para autenticar operaciones en el entorno de prueba. Puedes consultarla en la sección Credenciales de la aplicación, dentro del entorno de prueba. No permite procesar pagos reales, nunca debe exponerse en el frontend y comienza con el prefijo `APP_USR`.Acceder a las credenciales de prueba. | Requerido |
X-Idempotency-Key | Header | Llave de idempotencia. Esta llave garantiza que cada solicitud sea procesada una única vez, evitando duplicidades. Utiliza un valor exclusivo en el encabezado de tu solicitud, como un UUID V4 o strings aleatorias. | Requerido |
type | Body.String | Tipo de order, asociado a la solución de Mercado Pago para la que se crea. Para pagos con Mercado Pago Point, el único valor posible es point. | Requerido |
processing_mode | Body.String | Modo de procesamiento de la order. Para crear una order en modo reserva desde una terminal configurada en modo PDV, envía manual. | Requerido |
description | Body.String | Descripción de la order con un máximo de 150 caracteres. No puede estar vacía en modo reserva. | Requerido |
external_reference | Body.String | Es una referencia externa de la order, asignada al momento de su creación. Debe ser un valor único para cada order, y no puede contener datos PII. El límite máximo permitido es de 64 caracteres y los permitidos son: letras mayúsculas y minúsculas, números y los símbolos de guion (-) y guion bajo (_). | Requerido |
expiration_time | Body. String | Indica el período de validez de la order de pago a partir de su creación. Durante este tiempo, la order estará habilitada para ser procesada por el cliente; si no se procesa dentro del plazo especificado, expirará automáticamente y no podrá ser utilizada. El valor mínimo permitido es de 30 segundos (PT30S). En modo reserva, si no envías el parámetro, la order expirará después de 3 minutos (PT3M). Si envías un valor superior a 3 minutos, la API devolverá el error 400 - invalid_expiration_time y la order no será creada. | Opcional |
transactions.payments.amount | Body.String | Monto total de la order de pago. Admite hasta 2 decimales y el separador decimal es opcional. Ejemplos válidos: "10", "10.5" y "10.00". | Requerido |
config.point.terminal_id | Body.String | Identificador de la terminal Point que obtendrá la order. Debes enviarlo tal cual fue devuelto en el llamado Obtener terminalsGET, como en el siguiente ejemplo: NEWLAND_N950__N950NCB801293324. | Requerido |
config.payment_method.default_type | Body.String | Indica el medio de pago que aceptará la terminal. Para crear una order en modo reserva, el único valor permitido es credit_card. | Requerido |
Si la solicitud fue exitosa, la respuesta devolverá una order con estado created.
json{ "id": "ORD01ABCDEFGHIJKLMNOPQRSTUVWX", "type": "point", "external_reference": "ext_ref_1234", "description": "Reserva de hospedaje", "expiration_time": "PT2M", "processing_mode": "manual", "country_code": "MEX", "user_id": "5238400195", "status": "created", "status_detail": "created", "currency": "MXN", "created_date": "2026-09-01T20:00:30.683Z", "last_updated_date": "2026-09-01T20:00:30.683Z", "integration_data": { "application_id": "5302442096311419" }, "config": { "point": { "terminal_id": "PAX_A910__SMARTPOS123456789", "print_on_terminal": "seller_ticket" }, "payment_method": { "default_type": "credit_card" } }, "transactions": { "payments": [ { "id": "PAY01ABCDEFGHIJKLMNOPQRSTUVWX", "amount": "1500.00", "status": "created" } ] } }
La order avanza de forma asincrónica mientras la terminal procesa la operación. Cuando el comprador autoriza el pago en la terminal, la order transita al estado action_required con status_detail=waiting_capture. A partir de ese momento, puedes capturar el monto autorizado —total o parcialmente— o anular la reserva antes de confirmar el cobro.
Capturar order
Con la autorización y captura en dos pasos, puedes separar el momento en que los fondos se reservan en la tarjeta del comprador del momento en que el débito definitivo se confirma. Este flujo es útil cuando el monto final de la operación puede variar respecto al monto preautorizado, como en hospedajes, alquileres o cualquier escenario de retención de fondos.
Además, la captura solo es posible sobre orders con
status=action_required y status_detail=waiting_capture. Intentar capturar una order en cualquier otro status devolverá el error 409 - cannot_capture_order. Para más información sobre los posibles errores devueltos, accede a /v1/orders/{order_id}/capturePOST.Elige la opción que corresponda según el monto definitivo de la operación.
Confirma el cobro definitivo del 100% del monto autorizado en la creación de la order. El body de la solicitud debe ir vacío.
Para eso, envía una solicitud al endpoint /v1/orders/{order_id}/capturePOST, cuidando de incluir tu Access Token de pruebaClave privada vinculada a una aplicación, utilizada en el backend para autenticar operaciones en el entorno de prueba. Puedes consultarla en la sección Credenciales de la aplicación, dentro del entorno de prueba. No permite procesar pagos reales, nunca debe exponerse en el frontend y comienza con el prefijo `APP_USR`.Acceder a las credenciales de prueba y el id de la order a capturar, obtenido luego de su creación.
curlcurl --request POST \ --url https://api.mercadopago.com/v1/orders/{order_id}/capture \ --header 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}' \ --header 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \ --header 'Content-Type: application/json'
Consulta en la tabla a continuación las descripciones de los parámetros necesarios para esta solicitud.
| Atributo | Tipo | Descripción | Obligatoriedad |
order_id | Path | Identificador de la order a capturar. Este valor se devuelve en la respuesta a la solicitud de creación de la order. | Requerido |
Authorization | Header | Hace referencia a tu Access Token de pruebaClave privada vinculada a una aplicación, utilizada en el backend para autenticar operaciones en el entorno de prueba. Puedes consultarla en la sección Credenciales de la aplicación, dentro del entorno de prueba. No permite procesar pagos reales, nunca debe exponerse en el frontend y comienza con el prefijo `APP_USR`.Acceder a las credenciales de prueba. | Requerido |
X-Idempotency-Key | Header | Llave de idempotencia. Esta llave garantiza que cada solicitud sea procesada una única vez, evitando duplicidades. Utiliza un valor exclusivo en el encabezado de tu solicitud, como un UUID V4 o strings aleatorias. | Requerido |
Si la solicitud fue exitosa, la respuesta devolverá una order con estado processed.
json{ "id": "ORD01ABCDEFGHIJKLMNOPQRSTUVWX", "status": "processed", "status_detail": "accredited", "transactions": { "payments": [ { "id": "PAY01ABCDEFGHIJKLMNOPQRSTUVWX", "amount": "1500.00", "status": "processed", "status_detail": "accredited" } ] } }
Después de capturar correctamente la order, su status será processed y podrás reembolsarla total o parcialmente mediante el mismo flujo disponible para las demás orders procesadas.
La cancelación de una order se puede solicitar vía API o, cuando se encuentre en estado at_terminal, realizar directamente desde la terminal.
at_terminal, ya sea solicitada vía API o realizada desde la terminal, configura previamente tus notificaciones Webhooks. La notificación confirma que la cancelación se hizo efectiva y te permite mantener tu conciliación.-
Si el
statusde la order escreated, la cancelación debe realizarse vía API y se procesa de forma síncrona. -
Si su
statusesat_terminal, significa que la order ya fue obtenida por la terminal. En este caso, la cancelación puede solicitarse de forma asíncrona vía API o realizarse directamente desde la terminal.
Elige la opción que mejor se adecúe a tus necesidades para conocer cómo cancelar tu order.
Para cancelar una order con estado created o at_terminal vía API, envía una solicitud al endpoint /v1/orders/{order_id}/cancelPOST, incluyendo tu Access Token de pruebaClave privada vinculada a una aplicación, utilizada en el backend para autenticar operaciones en el entorno de prueba. Puedes consultarla en la sección Credenciales de la aplicación, dentro del entorno de prueba. No permite procesar pagos reales, nunca debe exponerse en el frontend y comienza con el prefijo `APP_USR`.Acceder a las credenciales de prueba y el ID de la order obtenido en la respuesta a su creación.
x-allow-cancelable-status no se envía o tiene un valor diferente de at_terminal, la solicitud de cancelación vía API de una order en status=at_terminal devolverá el error 409 cannot_cancel_order.
Además, la funcionalidad está disponible en terminales Point Smart 1 y Point Smart 2 que tengan la versión de software actualizada a la última disponible. De lo contrario, la solicitud se tratará como si el header no se hubiera enviado y devolverá el mismo error.
Una order creada en modo reserva solo puede cancelarse si todavía no fue capturada, es decir, cuando tiene status=action_required y status_detail=waiting_capture. En este caso, la cancelación funciona como un void: anula la autorización bancaria y libera los fondos retenidos en la tarjeta del comprador.
curlcurl -X POST \ 'https://api.mercadopago.com/v1/orders/{{ORDER_ID}}/cancel' \ -H 'Content-Type: application/json' \ -H 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \ -H 'x-allow-cancelable-status: at_terminal' \ -H 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}'
El resultado depende del estado de la order al momento de la solicitud:
- Para
created, la cancelación es síncrona y la API devuelveHTTP 200, con la order enstatus=canceledy el pago enstatus_detail=canceled_by_api. El headerx-allow-cancelable-statuses opcional y, cuando se envía, se ignora. - Para
at_terminal, la API acepta la solicitud de forma asíncrona y devuelveHTTP 202. La order permanece enstatus=at_terminal, mientras que el pago pasa a tenerstatus_detail=cancellation_requested, hasta que una notificación Webhook confirme la cancelación. Si el pago ya está en procesamiento, la terminal podrá priorizarlo y no completar la cancelación; por eso, la respuestaHTTP 202no debe interpretarse como la confirmación final.
Respuesta para una order en created
json{ "id": "ORD00009999222233334444555566", "user_id": "5238400195", "type": "point", "external_reference": "ext_ref_1234", "description": "Point Smart 2", "expiration_time": "PT16M", "country_code": "MEX", "currency": "MXN", "processing_mode": "automatic", "integration_data": { "application_id": "1234567890", "platform_id": "dev_1234567890", "integrator_id": "dev_1234567890", "sponsor": { "id": "446566691" } }, "status": "canceled", "status_detail": "canceled", "created_date": "2024-09-10T14:26:42.109320977Z", "last_updated_date": "2024-09-10T14:26:42.109320977Z", "config": { "point": { "terminal_id": "NEWLAND_N950__N950NCB801293324", "print_on_terminal": "no_ticket" }, "payment_method": { "default_type": "credit_card" } }, "transactions": { "payments": [ { "id": "PAY01J67CQQH5904WDBVZEM4JMEP4", "amount": "24.00", "status": "canceled", "status_detail": "canceled_by_api" } ] } }
Respuesta para una order en at_terminal
json{ "id": "ORD00009999222233334444555566", "status": "at_terminal", "status_detail": "at_terminal", "transactions": { "payments": [ { "id": "PAY01J67CQQH5904WDBVZEM4JMEP4", "status": "at_terminal", "status_detail": "cancellation_requested" } ] } }
La respuesta HTTP 202 solo confirma que la solicitud fue aceptada. Considera la order cancelada únicamente después de recibir la confirmación mediante las notificaciones Webhooks.
En caso de necesitarlo, es posible reembolsar una order creada mediante nuestra API. Este endpoint permite realizar la devolución total o parcial de una transacción de pago asociada a la order. Para solicitar un reembolso total, no es necesario enviar un body en la solicitud. Para el reembolso parcial, es necesario informar en el body el valor a reembolsar y el identificador de la transacción.
Elige la opción que mejor se adapte a tus necesidades y sigue las instrucciones correspondientes.
Para realizar el reembolso total de una order, envía una solicitud al endpoint /v1/orders/{order_id}/refundPOST sin enviar body en la solicitud. Asegúrate de incluir tu Access Token de pruebaClave privada vinculada a una aplicación, utilizada en el backend para autenticar operaciones en el entorno de prueba. Puedes consultarla en la sección Credenciales de la aplicación, dentro del entorno de prueba. No permite procesar pagos reales, nunca debe exponerse en el frontend y comienza con el prefijo `APP_USR`.Acceder a las credenciales de prueba. También es necesario informar el ID de la order (order_id) que deseas reembolsar, obtenido en la respuesta a su creación.
curlcurl -X POST \ 'https://api.mercadopago.com/v1/orders/{{ORDER_ID}}/refund' \ -H 'Content-Type: application/json' \ -H 'X-Idempotency-Key: {{SOME_UNIQUE_VALUE}}' \ -H 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}'
Si la solicitud fue exitosa, la respuesta mostrará el status=refunded y un nuevo nodo transactions.refunds, que contendrá los detalles del reembolso, junto con el ID del pago original (transactions.payments.id) y el ID de la transacción de reembolso (transaction_id).
json{ "id": "ORD00001111222233334444555566", "status": "refunded", "status_detail": "refunded", "transactions": { "refunds": [ { "id": "REF01J67CQQH5904WDBVZEM1234D", "transaction_id": "PAY01J67CQQH5904WDBVZEM4JMEP3", "reference_id": "12345678", "amount": "24.00", "status": "processed" } ] } }
Si lo necesitas, puedes consultar los datos de una order y sus transacciones asociadas, sean pagos o reembolsos, incluídos sus estados o valores.
Si bien la utilización recurrente de esta consulta vía API no es recomendada, sí puede resultar útil en caso de que requieras información adicional sobre la order.
Para consultar los datos de una order, envía una solicitud al endpoint /v1/orders/{order_id}GET, cuidando de incluir tu Access Token de pruebaClave privada vinculada a una aplicación, utilizada en el backend para autenticar operaciones en el entorno de prueba. Puedes consultarla en la sección Credenciales de la aplicación, dentro del entorno de prueba. No permite procesar pagos reales, nunca debe exponerse en el frontend y comienza con el prefijo `APP_USR`.Acceder a las credenciales de prueba, y el ID de la order (order_id) cuya información quieres consultar, obtenido en la respuesta a su creación.
curlcurl -X GET \ 'https://api.mercadopago.com/v1/orders/{{ORDER_ID}}' \ -H 'Content-Type: application/json' \ -H 'Authorization: Bearer {{YOUR_ACCESS_TOKEN}}'
Si la solicitud fue exitosa, la respuesta te devolverá toda la información de la order, incluidos su estado y el estado del pago y/o del reembolso en tiempo real:
json{ "id": "ORD00001111222233334444555566", "user_id": "5238400195", "type": "point", "external_reference": "ext_ref_1234", "processing_mode": "automatic", "description": "Point Smart 2", "expiration_time": "PT16M", "country_code": "MEX", "currency": "MXN", "integration_data": { "application_id": "1234567890", "platform_id": "dev_1234567890", "integrator_id": "dev_1234567890", "sponsor": { "id": "446566691" } }, "status": "refunded", "status_detail": "refunded", "created_date": "2024-09-10T14:26:42.109320977Z", "last_updated_date": "2024-09-10T14:26:42.109320977Z", "config": { "point": { "terminal_id": "NEWLAND_N950__N950NCB801293324", "print_on_terminal": "no_ticket" }, "payment_method": { "default_type": "credit_card" } }, "transactions": { "payments": [ { "id": "PAY01J67CQQH5904WDBVZEM4JMEP3", "amount": "24.00", "refunded_amount": "24.00", "paid_amount": "24.00", "status": "refunded", "status_detail": "refunded", "reference_id": "12345678", "payment_method": { "type": "credit_card", "installments": 6, "id": "master" } } ], "refunds": [ { "id": "REF01J67CQQH5904WDBVZEM1234D", "transaction_id": "PAY01J67CQQH5904WDBVZEM4JMEP3", "reference_id": "12345678", "amount": "24.00", "status": "processed" } ] } }