Criar intenção de pagamento

Este endpoint permite que você crie uma intenção de pagamento, ou seja, uma chamada que contém os detalhes de uma transação a ser realizada e atribuí-la a um dispositivo.

POST

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

OBRIGATÓRIO

Access Token obtido através do painel de desenvolvedores. Obrigatório ser enviado em todas as requisições.
x-test-scope
string
Este é um header temporário. Deve ser usado apenas para desenvolvimento com o valor "sandbox"
Path
deviceId
string

OBRIGATÓRIO

Identificador do dispositivo que irá receber a intenção de pagamento
Body
amount
integer

OBRIGATÓRIO

Um valor inteiro positivo que representa quanto carregar. O valor deve ter duas casas decimais na parte inteira (por exemplo, 175 para cobrar R$ 1,75).
description
string
Descrição da intenção de pagamento
payment
object
Propriedades da intenção de pagamento
additional_info
object
Informações adicionais de intenção de pagamento
Response parameters
id
string
Identificador de intenção de pagamento
device_id
string
Identificador do dispositivo ao qual a intenção de pagamento foi atribuída
amount
integer
Valor da intenção de pagamento
description
string
Descrição da intenção de pagamento
Erros

400Erro

400

Bad request - Field is missing o incorrect

401Erro

401

Unauthorized - Token is invalid

403Erro

403

Forbidden - Integrator isn't registered

409Erro

409

Conflict error - Device has a queued payment intent

500Erro

500

Internal server error

Informe dados válidos nos request parameters antes de executar.
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
  }
}