Start processing your payments - Integrate Mercado Pago Point with POS - Mercado Pago Developers

Start processing your payments

To start processing your payments, follow these steps:

Get the list of your available devices

Before creating a payment intent, you must obtain the list of Point devices associated with your account. You can do it in the following way:

curl

curl --location --request GET 'https://api.mercadopago.com/point/integration-api/devices' \
--header 'Authorization: Bearer ${ACCESS_TOKEN}' \

You will receive a response like this:

json

{
  "id":"7d8c70b6-2ac8-4c57-a441-c319088ca3ca",
  "device_id":"INGENICO_MOVE2500__ING-ARG-14886780",
  "amount":1500,
  "description":"this is an example",
  "payment":{
     "type":"credit_card",
     "installments":1
  },
  "additional_info":{
     "external_reference":"4561ads-das4das4-das4754-das456",
     "print_on_terminal":true
  }
}

Create the payment intent

You can create a payment intent and assign it to your Point device in the following way:

curl

curl --location --request POST 'https://api.mercadopago.com/point/integration-api/devices/:deviceId/payment-intents' \
--header 'Authorization: Bearer ${ACCESS_TOKEN}' \
--data-raw '{
   "amount": 1500,
   "description": “this is an example”,
   "payment": {
     "installments": 1,
     "type": “credit_card”
    },
   "additional_info": {
       "external_reference": "4561ads-das4das4-das4754-das456",
       "print_on_terminal": true
   }
}'
FieldDescription
amountTotal amount of the payment intent.
descriptionDescription of payment intent.
payment.typePayment method type.
payment.installmentsNumber of payment installments.
payment.installments_costCost for payment installments.
external_referenceField exclusively used by the integrator to include references to their system.
print_on_terminalField that determines if the device prints the payment receipt.

In response, you will receive something similar to this:

json

{
  "id":"7d8c70b6-2ac8-4c57-a441-c319088ca3ca",
  "device_id":"INGENICO_MOVE2500__ING-ARG-14886780",
  "amount":1500,
  "description":"this is an example",
  "payment":{
     "type":"credit_card",
     "installments":1
  },
  "additional_info":{
     "external_reference":"4561ads-das4das4-das4754-das456",
     "print_on_terminal":true
  }
}

Cancel a payment intent

You can cancel a payment intent assigned to a Point device in the following way:

curl

curl --location --request DELETE 'https://api.mercadopago.com/point/integration-api/devices/:deviceId/payment-intents/:paymentIntentId' \
--header 'Authorization: Bearer ${ACCESS_TOKEN}' \

You will receive this response:

json

{
 "id": "7d8c70b6-2ac8-4c57-a441-c319088ca3ca"
}

Process your payment intent

Once the payment intent has been created, you can obtain it from your Point device by pressing on the green key of the device and following the steps shown on the screen to complete the payment.

Check the status of your payment intent

You can check the current status of your payment intent using the id that you received in the response when creating the payment intent.

curl

curl --location --request GET 'https://api.mercadopago.com/point/integration-api/payment-intents/:paymentIntentID' \
--header 'Authorization: Bearer ${ACCESS_TOKEN}'

Sample response:

json

{
  "state":"FINISHED",
  "id":"f8f50814-a8c5-4524-95b6-672958523121",
  "device_id":"GERTEC_MP35P__8701016695109435",
  "description":"this is an example",
  "amount":1500,
  "payment":{
     "type":"credit_card",
     "installments":1
  },
  "additional_info":{
     "external_reference":"4561ads-das4das4-das4754-das456",
     "print_on_terminal":true
  }
}
Note
Check out all the information corresponding to the payment in the section Payment API of our API Reference.