Este endpoint permite crear una order para transacciones de pago con Mercado Pago Point. En caso de éxito, la solicitud devolverá una respuesta con el estado 201.
POST
REQUERIDO
REQUERIDO
REQUERIDO
point.REQUERIDO
REQUERIDO
type es point, solo es posible incluir 1 transacción por order.400Error.
empty_required_header
El header X-Idempotency-Key es requerido y no fue enviado. Vuelve a realizar la petición incluyéndolo.
required_properties
Algunas propiedades requeridas están ausentes. Verifique el mensaje devuelto en los detalles del error para identificar el problema y vuelva a intentarlo enviando la información faltante.
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_installments_cost_config
El vendedor tiene una restricción que impide el uso de cuotas sin o con intereses. Verifica que el vendedor haya completado la configuración de cuotas en su cuenta de Mercado Pago.
invalid_default_installments
El número de cuotas solicitado no está entre las opciones habilitadas por el vendedor. Envía un valor de default_installments dentro de las opciones disponibles configuradas para ese vendedor en la cuenta de Mercado Pago.
missing_installments_cost
El número de cuotas (default_installments) es mayor que 1 y no se indicó quién será el responsable financiero del costo de estas cuotas (installments_cost). Rehaz la operación agregando installments_cost con valor seller o buyer.
invalid_installments_cost_single
Definir que los costos de las cuotas son del comprador (installments_cost=buyer) es inválido cuando default_installments=1 porque una sola cuota no tiene costo financiero. Rehaz la operación usando installments_cost=seller u omite ambos campos.
invalid_payment_method_for_installments
Los campos default_installments e installments_cost solo pueden enviarse cuando el medio de pago definido sea tarjeta de crédito. Rehaz la operación agregando default_type=credit_card al payload o elimina los campos de cuotas si el pago es con tarjeta de débito.
minimum_amount_not_met
El monto de la transacción es menor al mínimo requerido para el plan de cuotas solicitado. Aumenta el monto o reduce el número de cuotas.
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.
403Error.
forbidden_checking_terminal_owner
La terminal Point no pertenece al usuario que envió la solicitud. Verifica si el valor enviado para terminal_id es correcto o si la terminal está vinculada a tu cuenta.
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.
already_queued_order_for_terminal
La terminal ya tiene una order en espera. Es necesario finalizarla o cancelarla para enviar nuevas orders.
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.
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: 6b54fd26-1e50-4091-8358-93d7bc8c9bcd' \
-d '{
"type": "point",
"external_reference": "ext_ref_1234",
"expiration_time": "PT2M",
"transactions": {
"payments": [
{
"amount": "50.00"
}
]
},
"config": {
"point": {
"terminal_id": "NEWLAND_N950__SBX0000001",
"print_on_terminal": "no_ticket"
},
"payment_method": {
"default_type": "credit_card",
"default_installments": 6,
"installments_cost": "seller"
}
},
"description": "Smartphone",
"integration_data": {
"platform_id": "dev_1234567890",
"integrator_id": "dev_123456",
"sponsor": {
"id": "446566691"
}
}
}'{
"id": "ORD00001111222233334444555566",
"type": "point",
"user_id": "5238400195",
"external_reference": "ext_ref_1234",
"description": "Smartphone",
"expiration_time": "PT2M",
"processing_mode": "automatic",
"country_code": "BR",
"currency": "BRL",
"integration_data": {
"application_id": "1234567890",
"platform_id": "dev_1234567890",
"integrator_id": "dev_123456",
"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__SBX0000001",
"print_on_terminal": "no_ticket"
},
"payment_method": {
"default_type": "credit_card",
"default_installments": 6,
"installments_cost": "seller"
}
},
"transactions": {
"payments": [
{
"id": "PAY01J67CQQH5904WDBVZEM4JMEP3",
"amount": "50.00",
"status": "created"
}
]
}
}