Este endpoint permite crear una order para transacciones de pago con Wallet Connect. En caso de éxito, la solicitud devolverá una respuesta con el estado 201.
POST
REQUERIDO
REQUERIDO
REQUERIDO
online.REQUERIDO
REQUERIDO
automatic.400Error de solicitud.
empty_required_header
El header X-Idempotency-Key es requerido y no fue enviado. Vuelve a realizar la solicitud incluyéndolo.
invalid_idempotency_key_length
El X-Idempotency-Key debe tener entre 1 y 64 caracteres.
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 no 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 requeridas.
property_type
Se envió un tipo de propiedad incorrecto. Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.
minimum_items
La longitud del array está por debajo del mínimo permitido.
maximum_items
La longitud del array supera el máximo permitido.
property_value
Se envió un valor incorrecto 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 proporcionó información incorrecta.
invalid_total_amount
El valor ingresado en total_amount no es equivalente a la suma del campo transactions.payments.amount del total de las transacciones. Por favor, verifica que los valores sean correctos.
invalid_order_type
El type de la order es inválido o no está soportado.
401Error. Token de pago no autorizado.
unauthorized_payer_token
El payer_token proporcionado no está autorizado para esta transacción. Verifica que el token sea válido y pertenezca al pagador autenticado.
invalid_credentials
No hay soporte para credenciales de prueba. Utiliza usuarios de prueba con credenciales de producción para el entorno de prueba (sandbox) y tus credenciales de producción para el entorno de producción.
402Error de procesamiento.
402
La order fue creada, pero alguna transacción ha fallado. Consulte el campo errors para obtener más información.
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 (X-Idempotency-Key) ya fue utilizado. Por favor, vuelve a intentar realizar la solicitud enviando un nuevo valor.
operation_not_supported
La operación no es soportada para esta order. Comprueba el status y status_detail de la order e intenta nuevamente.
422Error.
unprocessable_entity
El perfil de pago asociado al payer_token está corrompido o incompleto.
423Recurso bloqueado.
resource_locked
La clave de idempotencia (X-Idempotency-Key) está bloqueada por una solicitud en curso. Por favor, reintenta después de un breve tiempo.
500Error genérico.
idempotency_validation_failed
Falla en la validación de idempotencia. Intenta enviar la solicitud nuevamente.
internal_error
Error genérico. Intenta enviar la solicitud nuevamente.
curl -X POST \
'https://api.mercadopago.com/v1/orders'\
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer APP_USR-8*********88776-122*********fc20dede6*********a497d7225*********64' \
-H 'X-Idempotency-Key: 86981347-6f85-4819-81a1-f44fb605c950' \
-d '{
"type": "online",
"external_reference": "ext_ref_1234",
"total_amount": "50.00",
"description": "Smartphone",
"capture_mode": "automatic",
"integration_data": {
"platform_id": "123abc"
},
"transactions": {
"payments": [
{
"amount": "50.00",
"payment_method": {
"type": "wallet",
"id": "wallet",
"token": "123abc123abc123abc123abc123abc12",
"statement_descriptor": "My Store"
},
"stored_credential": {
"reason": "recurring",
"payment_initiator": "merchant"
}
}
]
},
"additional_info": {
"sub_merchant": {
"id": "123123",
"mcc": "5462",
"country": "BR",
"address_door_number": 3003,
"zip": "06233-903",
"document_number": "19119119100",
"city": "Osasco",
"address_street": "RUA A",
"legal_name": "LOJINHA DO ZÉ",
"region_code_iso": "BR-MG",
"region_code": "BR",
"document_type": "CPF",
"phone": "98765-4321",
"url": "www.nomedofacilitador.com.br"
}
}
}'{
"id": "ORDBTA01KHY4WFPYXJ9Z7S5CGED7WCTP",
"type": "online",
"processing_mode": "automatic",
"external_reference": "ext_ref_1234",
"description": "Smartphone",
"total_amount": "50.00",
"total_paid_amount": "50.00",
"country_code": "BR",
"user_id": "1090806071",
"status": "processed",
"status_detail": "accredited",
"capture_mode": "automatic",
"currency": "BRL",
"created_date": "2026-02-20T18:27:08.639Z",
"last_updated_date": "2026-02-20T18:27:09.797Z",
"integration_data": {
"application_id": "8251964915044164",
"platform_id": "123abc"
},
"transactions": {
"payments": [
{
"id": "PAY01KHY4WFPYXJ9Z7S5CGG0SE8KN",
"amount": "50.00",
"paid_amount": "47.28",
"reference_id": "30f45a189ec043c28e6c4b73e0dd65a3",
"status": "processed",
"status_detail": "accredited",
"attempts": [
{
"id": "514336a54ba74712a2478d0e79c92b14",
"status": "processed",
"status_detail": "accredited",
"payment_method": {
"id": "wallet",
"type": "wallet",
"installments": 1
}
}
],
"payment_method": {
"id": "wallet",
"type": "wallet",
"statement_descriptor": "Descriptor",
"installments": 1
},
"stored_credential": {
"payment_initiator": "merchant",
"reason": "recurring"
}
}
]
}
}