Comienza a procesar tus pagos

Sigue los pasos a continuación para comenzar a procesar tus pagos con Punto de Venta (PDV).

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 a través del siguiente llamado:

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:

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

Crea la intención de pago

Una intención de pago es un llamado que contiene los detalles de la transacción a realizarse, y que debe ser creada para poder iniciar un cobro. Se trata de un intento que, de ser exitoso, devolverá un id del pago y su estado.

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

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"
    }
}'

Campo	Descripción
`amount`	Monto total de la intención de pago. Monto mínimo permitido: 500 (dispositivos POS y SMART). Monto máximo permitido: 400000000 (ambos dispositivos). Importante: este campo no admite puntos decimales. 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:

{
  "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 --location --request DELETE 'https://api.mercadopago.com/point/integration-api/devices/:deviceId/payment-intents/:paymentIntentId' \
--header 'Authorization: Bearer ${ACCESS_TOKEN}' \

Obtendrás esta respuesta:

{
  "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”).

Luego, continúa con los pasos que se muestran en la pantalla para completar el pago.

Importante

Recomendamos evaluar la calidad de tu integración para validar si estás cumpliendo con los estándares de calidad y seguridad de Mercado Pago que pueden mejorar tu tasa de aprobación de pagos.

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 crearla.

Recuerda que id y estado de la intención de pago son diferentes a id y estado del pago. En este caso, se trata de consultar los detalles de un intento. Si quieres consultar la información correspondiente al pago, accede a la sección API de Pagos en Referencia de API.

Importante

El mecanismo principal recomendado para conocer el resultado de una intención de pago es la suscripción a las notificaciones de integraciones . Aconsejamos utilizar el endpoint aquí presente sólo como mecanismo alternativo.

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

Recibirás una respuesta similar a la siguiente:

{
    "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"
    }
}

Importante

Confirmation_required es un estado final y no cambiará una vez recibido. Si efectivamente lo recibes en el estado de la intención, deberás confirmar en tu dispositivo cuál es el estado del pago que se corresponde con el payment_id recibido en la respuesta. No entregues tu producto o servicio hasta verificarlo.

Puedes consultar los estados posibles de una intención de pago accediendo a nuestro Glosario.

Integrar API

Vea más información para empezar a integrar la API de Integraciones a tus Puntos de Venta.

Configurar notificaciones

Descubra cómo comenzar a recibir notificaciones de Webhooks.