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-7434*********159-03141*********cee51edf8*********f94f589-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"
      }
    }
  ]
}