Home
Documentation
Resources
Partners
Community

Resources

Check for updates on our solutions and system performance, or request technical support.

Partners

Discover our program for agencies or developers that offer integration services and sellers who want to hire them.

Community

Get the latest news, ask others for help and share your knowledge.

Create payment intent - Payment intent - Mercado Pago Developers

Intelligent search powered by OpenAI 

Create payment intent

POST

https://api.mercadopago.com/point/integration-api/devices/{deviceid}/payment-intents
This endpoint allows to create a payment intent, which is a call that contains all the details of a transaction, and assign it to a device.
Request's parameters
HEADER
x-test-scope
string
This is a temporary header. It should be used only in the development stage with the value "sandbox". When going to production, it should be removed
PATH
deviceId
string

REQUIRED

Identifier of the device that will receive the payment intent
BODY
amount
integer

REQUIRED

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).
additional_info
object
Payment intent additional info.
Response parameters
id
string
Payment intent identifier.
device_id
string
Identifier of the device to which the payment intent was assigned.
amount
integer
Payment intent amount.
additional_info
object
Payment intent additional info.
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-4599*********755-11221*********d497ae962*********ecf8d85-1*********' \
    -d '{
  "amount": 1500,
  "additional_info": {
    "external_reference": "some-reference-from-your-application",
    "print_on_terminal": false,
    "ticket_number": "S0392JED"
  }
}'
Sample answer
{
  "id": "7f25f9aa-eea6-4f9c-bf16-a341f71ba2f1",
  "device_id": "PAX_A910__SMARTPOS1234345545",
  "amount": 1500,
  "additional_info": {
    "external_reference": "someone-reference-from-your-application",
    "print_on_terminal": true,
    "ticket_number": "S0392JED"
  }
}