Crear intención de pago

Este endpoint permite crear una intención de pago, es decir, un llamado que contiene los detalles de una transacción a realizarse, y asignarla a un dispositivo.

POST

https://api.mercadopago.com/point/integration-api/devices/{deviceid}/payment-intents
Request parameters
Header
Authorization
string

REQUERIDO

Access Token obtenido a través del panel de desarrollador. Obligatorio ser enviado en todas las solicitudes.
x-test-scope
string
Este es un header temporal. Debe usarse sólo para la etapa de desarrollo con el valor "sandbox"
Path
deviceId
string

REQUERIDO

Identificador del dispositivo que recibirá la intención de pago
Body
amount
integer

REQUERIDO

Un valor entero positivo que representa cuánto cobrar. El valor debe tener dos decimales en la parte entera (por ejemplo, 175 para cobrar $1,75).
description
string
Descripción de la intención de pago
payment
object
Propiedades de la intención de pago
additional_info
object
Información adicional de intención de pago
Response parameters
id
string
Identificador de intención de pago
device_id
string
Identificador del dispositivo al que se asignó la intención de pago
amount
integer
Importe de la intención de pago
description
string
Descripción de la intención de pago
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 'Authorization: Bearer APP_USR-8*********88776-122*********fc20dede6*********a497d7225*********64' \
       -H 'x-test-scope: sandbox' \
    -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
  }
}'
Response
{
  "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
  }
}