Intelligent search powered by OpenAI
Create payment intent
POST
Products that use it:
Request's parameters
HEADER
x-test-scope
This is a temporary header. It should be used only in the development stage with the value "sandbox"string
PATH
deviceId
Identifier of the device that will receive the payment intentstring
REQUIRED
BODY
amount
A positive integer representing how much to charge. The value must have two decimal places in the integer part (e.g., 175 to charge $1.75).integer
REQUIRED
description
Payment intent descriptionstring
payment
Properties of the payment intentobject
additional_info
Payment intent additional infoobject
Response parameters
id
Payment intent identifierstring
device_id
Identifier of the device to which the payment intent was assignedstring
amount
Payment intent amountinteger
description
Payment intent descriptionstring
Errors
400Error
400
Bad request - Field is missing o incorrect
401Error
401
Unauthorized - Token is invalid
403Error
403
Forbidden - Integrator isn't registered
409Error
409
Conflict error - Device has a queued payment intent
500Error
500
Internal server error
Request
curl -X POST \
'https://api.mercadopago.com/point/integration-api/devices/{deviceid}/payment-intents'\
-H 'Content-Type: application/json' \
-H 'x-test-scope: sandbox' \
-H 'Authorization: Bearer TEST-7434*********159-03141*********cee51edf8*********f94f589-1*********' \
-d '{
"amount": 1500,
"description": "your payment intent description",
"payment": {
"installments": 1,
"type": "credit_card",
"installments_cost": "seller"
},
"additional_info": {
"external_reference": "4561ads-das4das4-das4754-das456",
"print_on_terminal": false
}
}'
Sample answer
{
"id": "7f25f9aa-eea6-4f9c-bf16-a341f71ba2f1",
"device_id": "PAX_A910__SMARTPOS1234345545",
"amount": 1500,
"description": "your payment intent description",
"payment": {
"installments": 1,
"type": "credit_card",
"installments_cost": "seller"
},
"additional_info": {
"external_reference": "someone-reference-from-your-application",
"print_on_terminal": true
}
}