Este endpoint permite crear una order para Código QR para transacciones de pago y de retiro de dinero. Es posible crear una transacción de pago, una transacción de retiro, o ambas al mismo tiempo. En caso de éxito, la solicitud devolverá una respuesta con el estado 201.
POST
REQUERIDO
REQUERIDO
REQUERIDO
REQUERIDO
400Error.
bad_request
Se intentó crear la order con campos no soportados o inválidos. Vuelve a intentar enviar la solicitud, validando todos los campos.
empty_required_header
El header "X-Idempotency-Key" es requerido y no fue enviado. Vuelve a realizar la petición incluyéndolo.
marketplace_not_valid
El Access Token enviado como header en la requisición no es uno obtenido mediante el protocolo OAuth y, por lo tanto, no es posible identificar un marketplace válido. Verifica haber realizado el proceso correctamente.
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.
property_type
Se envió un tipo 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.
sponsor_id_not_valid
Se envió un valor inválido como identificador de la cuenta de Mercado Pago (USER_ID). Chequea el mensaje devuelto en los detalles del error para saber cuál fue el problema y vuelve a intentarlo.
seller_configuration
El vendedor no está autorizado para hacer solicitudes con transacciones de retiro de dinero ("cash_out"). Asegúrate de comunicarte con tu contacto comercial de Mercado Pago para dar de alta al usuario e intenta de nuevo.
unsupported_site
Se ha intentado crear la order desde un país que no es soportado. Asegúrate de contar con la autorización necesaria.
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.
401Error.
unauthorized
El valor enviado como Access Token es incorrecto. Por favor, verifícalo y vuelve a intentar realizar la petición enviando el valor correcto.
404Error.
marketplace_fee_not_allowed
No está permitido enviar el campo "marketplace_fee" debido a que el marketplace no fue encontrado. Por favor, valida que estés utilizando el Access Token correcto e intenta nuevamente.
pos_not_found
El valor ingresado para el campo "external_pos_id" no pertenece a ninguna caja. Valida haber ingresasado el correcto y vuelve a intentarlo.
409Error.
idempotency_key_already_used
El valor enviado como header de idempotencia ya fue utilizado con una solicitud distinta en un tiempo menor a 24 horas. Por favor, vuelve a intentar realizar la petición enviando un nuevo valor.
500Error.
500
Error genérico. Verifica el mensaje retornado e 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: ab7a329f-326b-4042-99e8-3bdc21bc4375' \
-d '{
"type": "qr",
"total_amount": "50.00",
"description": "Smartphone",
"external_reference": "ext_ref_1234",
"expiration_time": "PT16M",
"marketplace_fee": "11.20",
"integration_data": {
"platform_id": "dev_1234567890",
"integrator_id": "dev_1234",
"sponsor": {
"id": "446566691"
}
},
"config": {
"qr": {
"external_pos_id": "EXTERNALPOS019285",
"mode": "hybrid"
}
},
"transactions": {
"payments": [
{
"amount": "24.50"
}
],
"cash_outs": [
{
"amount": "24.50",
"additional_info": {
"fixed_amount": true,
"agency_type": "AGTEC",
"bank_service_code": "abc123"
}
}
]
},
"items": [
{
"title": "Smartphone",
"unit_price": "24.50",
"quantity": 1,
"unit_measure": "kg",
"external_code": "777489134",
"external_categories": [
{
"id": "device"
}
]
}
],
"discounts": {
"payment_methods": [
{
"new_total_amount": "47.28",
"type": "account_money"
}
]
}
}'{
"id": "ORD00001111222233334444555566",
"user_id": "5238400195",
"type": "qr",
"external_reference": "ext_ref_1234",
"description": "Smartphone",
"expiration_time": "PT16M",
"processing_mode": "automatic",
"total_amount": "50.00",
"country_code": "BR",
"marketplace_fee": "11.20",
"integration_data": {
"application_id": "dev_1234567890",
"platform_id": "dev_1234567890",
"integrator_id": "dev_1234",
"sponsor": {
"id": "446566691"
}
},
"status": "created",
"status_detail": "created",
"currency": "BRL",
"created_date": "2024-09-10T14:26:42.109Z",
"last_updated_date": "2024-09-10T14:27:42.109Z",
"config": {
"qr": {
"external_pos_id": "EXTERNALPOS019285",
"mode": "hybrid"
}
},
"transactions": {
"payments": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "24.50",
"status": "created",
"status_detail": "ready_to_process"
}
],
"cash_outs": [
{
"id": "CAS01J67CQQH5904WDBVZEM4JMEP3",
"amount": "24.50",
"status": "created",
"status_detail": "ready_to_process",
"additional_info": {
"fixed_amount": "true",
"agency_type": "AGTEC",
"bank_service_code": "abc123"
}
}
]
},
"items": [
{
"title": "Smartphone",
"unit_price": "24.50",
"quantity": 1,
"unit_measure": "kg",
"external_code": "777489134",
"external_categories": [
{
"id": "food"
}
]
}
],
"discounts": {
"payment_methods": [
{
"new_total_amount": "47.28",
"type": "account_money"
}
]
},
"type_response": {
"qr_data": "00020101021243650016com.mercadolibre020130636261ba79b-e543-41c7-b71a-cec05c18e72b50120008326594305204970053030325802AR5904Test6004CABA63041094"
}
}