Procesar pagos - Integrar con PDV - Mercado Pago Developers

Comienza a procesar tus pagos

Para comenzar a procesar tus pagos, sigue estos pasos:

Obtén el listado de tus dispositivos disponibles

Antes de crear una intención de pago, debes obtener los dispositivos Point asociados a tu cuenta. Puedes hacerlo de esta manera:

curl

curl --location --request GET 'https://api.mercadopago.com/point/integration-api/devices?offset=0&limit=50' \ 
--header 'Authorization: Bearer ${ACCESS_TOKEN}' 

Recibirás una respuesta como esta:

json

{
   "devices": [
       {
           "id": "INGENICO_MOVE2500__ING-ARG-1123345670",
           "operating_mode": "STANDALONE"
       },
       {
           "id": "INGENICO_MOVE2500__ING-ARG-0987654P",
           "operating_mode": "STANDALONE"
       },
       {
           "id": "INGENICO_MOVE2500__ING-5467853",
           "operating_mode": "PDV"
       },
       {
           "id": "INGENICO_MOVE2500__ING-ARG-1233456",
           "operating_mode": "STANDALONE"
       }
   ],
   "paging": {
       "total": 4,
       "limit": 50,
       "offset": 0
   }
}

Crea la intención de pago

Puedes crear una intención de pago y asignarla a tu dispositivo Point de esta manera:

curl

curl --location --request POST 'https://api.mercadopago.com/point/integration-api/devices/{{device.id}}/payment-intents' \
--header 'Authorization: Bearer ${ACCESS_TOKEN}' \
--data-raw '{
    "amount": 1500,
    "additional_info": {
        "external_reference": "4561ads-das4das4-das4754-das456",
        "print_on_terminal": true,
        "ticket_number": "S0392JED"
    }
}'
CampoDescripción
'amount'Monto total de la intención de pago. Importante: este campo no admite puntos decimales, por lo tanto si deseas generar una intención de pago, debes contemplar los dos decimales del valor en su total. Por ejemplo: para generar orden de pago de valor "15,00" deberás ingresar "1500".
'external_reference'Campo de uso exclusivo del integrador para incluir referencias propias de su sistema.
'print_on_terminal'Campo que determina si el dispositivo realiza la impresión del comprobante de pago.
'ticket_number'Número de ticket de la intención de pago.

Como respuesta, recibirás algo similar a esto:

json

{
  "id": "7d8c70b6-2ac8-4c57-a441-c319088ca3ca",
  "device_id": "INGENICO_MOVE2500__ING-ARG-14886780",
  "amount": 1500,
  "additional_info": {
      "external_reference": "4561ads-das4das4-das4754-das456",
      "print_on_terminal": true,
      "ticket_number": "S0392JED"
  }
}

Cancela una intención de pago

Puedes cancelar una intención de pago asignada a un dispositivo Point de la siguiente manera:

curl

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

Obtendrás esta respuesta:

json

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

Procesa tu intención de pago

Una vez creada la intención de pago, puedes obtenerla desde tu dispositivo Point oprimiendo el botón para iniciar cobro (en caso de Point Plus y Point Pro 2 el botón verde y, en el caso de Point Smart, el botón digital “Cobrar ahora”) y continuando con los pasos que se muestran en la pantalla para completar el pago.

Consulta el estado de tu intención de pago

Puedes consultar el estado actual de tu intención de pago utilizando el id que recibiste en la respuesta al momento de crear la intención de pago.

curl

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

Ejemplo de respuesta:

json

{
    "state": "FINISHED",
    "id": "0aa0519d-d985-4e83-b62d-dda123456789",
    "device_id": "88731317_INGENICO_MOVE2500_ING-ARG-14123456",
    "amount": 600,
    "payment": {
        "id": "11123456789"
    },
    "additional_info": {
        "ticket_number": "123456789123456789"
    }
}
Nota
Consulta toda la información correspondiente al pago en la sección API de Pagos de Referencia de API.