Inicio
Documentación
Recursos
Partners
Comunidad

Recursos

Revisa las actualizaciones de nuestras soluciones y operatividad del sistema o pide soporte técnico.

Partners

Conoce nuestro programa para agencias o desarrolladores que ofrecen servicios de integración y vendedores que quieren contratarlos.

Comunidad

Recibe las últimas novedades, pide ayuda a otros integradores y comparte tus conocimientos.

Agregar transacciones a la order - Pagos online - Mercado Pago Developers

Búsqueda inteligente powered by OpenAI 

Agregar transacciones a la order

POST

https://api.mercadopago.com/v1/orders/{order_id}/transactions
Este endpoint permite añadir transacciones de pago a la order. Esta operación solo puede realizarse en el modo manual (procesando la transacción en etapas que pueden ser configuradas y ejecutadas de manera incremental), con el campo 'processing_mode' con valor 'manual'. En caso de éxito, la solicitud devolverá una respuesta con el estado 201.
Parámetros para la solicitud
HEADER
X-Idempotency-Key
string

REQUERIDO

Esta función permite repetir solicitudes de manera segura, sin el riesgo de realizar la misma acción más de una vez por error. Esto es útil para evitar errores, como la creación de dos pagos idénticos. Para garantizar qu...Ver más
PATH
id
string

REQUERIDO

Identificador de la orden, devuelto en la respuesta a la requisición para su creación.
BODY
payments
array
Contiene información sobre la order de pago. En caso de querer crear una order con dos tarjetas, puedes agregar un ítem al array, dividiendo el monto de la transacción y señalando un medio de pago diferente en cada uno.
Parámetros de respuesta
payments
array
Contiene información sobre el pago asociado a una order.
Errores

400Error.

empty_required_header

El header 'X-Idempotency-Key' es requerido y no fue enviado. Vuelve a realizar la requisición incluyéndolo.

invalid_path_param

El order_id proporcionado en el path de la requisición no es correcto. Compruébalo y proporciona un ID válido para volver a intentarlo.

required_properties

Ciertas propiedades requeridas están ausentes. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

unsupported_properties

Se envió una propiedad que no es soportada. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

minimum_properties

No se envió el número mínimo de propiedades necesarias para ejecutar la solicitud. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

property_type

Se envió un tipo de propiedad incorrecto. Por ejemplo, un valor 'integer' para una propiedad 'string'. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

minimum_items

No se envió el número mínimo de ítems para alguna propiedad. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

maximum_items

Se envió una cantidad mayor de ítems que la permitida para alguna propiedad. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

property_value

Se envió un valor inválido para alguna propiedad. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

json_syntax_error

Se envió un JSON inválido. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

invalid_properties

Se envió información incorrecta. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.

exceeded_number_of_transactions

Ocurrió un error en la solicitud. La order acepta un máximo de dos transacciones. Elimine las transacciones excedentes.

401Error. Access Token no autorizado.

401

El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la requisición enviando el valor correcto.

404Error. Order no encontrada.

order_not_found

Order no encontrada. Comprueba si enviaste el ID correcto.

409Alguna regla específica del sistema no permite realizar la acción debido a restricciones definidas.

idempotency_key_already_used

El valor enviado como header de idempotencia ya fue utilizado. Por favor, vuelve a intentar realizar la requisición enviando un nuevo valor.

500Error.

idempotency_validation_failed

Falla en la validación de idempotencia. Intenta enviar la solicitud nuevamente.

500

Error genérico. Intenta enviar la solicitud nuevamente.

Solicitud
curl -X POST \
    'https://api.mercadopago.com/v1/orders/{order_id}/transactions'\
    -H 'Content-Type: application/json' \
       -H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
       -H 'Authorization: Bearer TEST-4599*********755-11221*********d497ae962*********ecf8d85-1*********' \
    -d '{
  "payments": [
    {
      "amount": "24.90",
      "payment_method": {
        "id": "visa",
        "type": "credit_card",
        "token": "12345",
        "installments": 1,
        "statement_descriptor": "approved"
      }
    }
  ]
}'
Respuesta de ejemplo
{
  "payments": [
    {
      "id": "pay_01J67CQQH5904WDBVZEM4JMEP3",
      "amount": "24.90",
      "status": "processed",
      "status_detail": "accredited",
      "payment_method": {
        "id": "visa",
        "type": "credit_card",
        "token": "12345",
        "installments": 1,
        "statement_descriptor": "approved"
      }
    }
  ]
}