POST
REQUIRED
REQUIRED
REQUIRED
REQUIRED
REQUIRED
400Error
empty_required_header
The 'X-Idempotency-Key' header is required and was not sent. Make the request again including it.
required_properties
There are some required properties missing. Check the message returned in the error details to find out what the problem was and try again.
unsupported_properties
An unsupported property was sent. Check the message returned in the error details to find out what the problem was and try again.
property_type
The wrong property type was submitted. For example, an 'integer' value for a 'string' property. Check the message returned in the error details to find out what the problem was and try again.
property_value
An incorrect value for some property was sent. Check the message returned in the error details to find out what the problem was and try again.
content is required
The content field is not present in the request body.
The content file size exceeds the limit 1MB
The content of the content field exceeds the allowed size limit of 1MB.
Error decoding base64, the provided base64 string is not valid.
The encoding of the image in base64 is incorrect.
401Error.
unauthorized
The value sent as Access Token is incorrect. Please check and try again with the correct value.
403Error.
forbidden_checking_terminal_owner
The Point terminal does not belong to the user who submitted the request. Check if the value sent for "terminal_id" is correct or if the terminal is linked to your account.
409Error.
idempotency_key_already_used
The value sent as the idempotency header has already been used with a different request within the last 24 hours. Please try the request again sending a new value.
already_queued_order_for_terminal
The terminal already has an order waiting. It is necessary to finalize or cancel it to send new orders.
500Error.
idempotency_validation_failed
Validation fail. Please try submitting the request again.
500
Generic error. Please try submitting the request again.
curl -X POST \
'https://api.mercadopago.com/terminals/v1/actions'\
-H 'Content-Type: application/json' \
-H 'X-Idempotency-Key: 0d5020ed-1af6-469c-ae06-c3bec19954bb' \
-H 'Authorization: Bearer TEST-8971*********918-01191*********5874530a4*********4799fdf-1*********' \
-d '{
"type": "print",
"external_reference": "ext_ref_1234",
"config": {
"point": {
"terminal_id": "NEWLAND_N950__N950NCB123456789",
"subtype": "image"
}
},
"content": "iVBORw0KGgoAAAANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU5ErkJggg=="
}'{
"id": "8952c6cf-bbb4-482c-a9f2-ea5fecd3ecd2",
"type": "print",
"external_reference": "ext_ref_1234",
"status": "created",
"config": {
"point": {
"terminal_id": "NEWLAND_N950__N950NCB123456789",
"subtype": "image"
}
}
}