Configurar notificaciones

Si quieres, puedes recibir notificaciones de Webhooks. Estas se envían desde nuestra API de Integraciones a tu sistema receptor mediante una llamada HTTP POST, y te alertan sobre todos los cambios relacionados a los estados de las intenciones de pago.

Para integrarlas, sigue las instrucciones de la documentación sobre notificaciones Webhook. Deberás activar los eventos de Integraciones Point para recibir estas actualizaciones.

Una vez que hayas implementado las notificaciones y realizado los ajustes necesarios, estas tendrán el siguiente formato:

Es el estado final de una intención de pago cuando finaliza la transacción.

{
 "amount": 100,
 "caller_id": 09876543,
 "client_id": 1234567890,
 "created_at": "2021-11-29 17:10:37",
 "id": "abcdef123-8ab5-4139-9aa3-abcd123",
 "payment": {
   "id": 123456789,
   "state": "approved",
   "type": "credit_card"
 },
 "state": "FINISHED",
 "additional_info": {
   "external_reference": "information"
 }
}

Sucede cuando la intención de pago finalizó sin recibir un estado del pago. Una vez obtenido, este estado no cambiará. Cuando es recibido, debes confirmar en tu dispositivo cuál es el estado del pago, utilizando el payment_id recibido en la respuesta, antes de entregar tu producto o servicio.

{
"amount": 100,
"caller_id": 09876543,
"client_id": 1234567890,
"created_at": "2021-11-29 17:10:37",
"id": "abcdef123-8ab5-4139-9aa3-abcd123",
"payment": {
  "id": 123456789,
  "state": "",
  "type": ""
},
"state": "CONFIRMATION_REQUIRED",
"additional_info": {
  "external_reference": "information"
}
}

Es el estado final de una intención de pago cuando se cancela.

{
 "amount": 100,
 "caller_id": 09876543,
 "client_id": 1234567890,
 "created_at": "2021-11-29 17:10:37",
 "id": "abcdef123-8ab5-4139-9aa3-abcd123",
 "state": "CANCELED",
 "additional_info": {
   "external_reference": "information"
 }
}

Estado final de una intención de pago cuando ocurre un error en la transacción.

{
 "amount": 100,
 "caller_id": 09876543,
 "client_id": 1234567890,
 "created_at": "2021-11-29 17:10:37",
 "id": "abcdef123-8ab5-4139-9aa3-abcd123",
 "state": "ERROR",
 "additional_info": {
   "external_reference": "information"
 }
}

Al recibir notificaciones sobre eventos generados por cada uno de tus dispositivos point, lograrás tener control y hacer un seguimiento de los mismos. Estas notificaciones pueden ser ocasionadas por:

• Reinicios de la terminal.
• Deslogueos.
• Cambio en el modo de operación de PDV a STANDALONE o viceversa.

Las notificaciones llegarán a tu correo electrónico registrado en Mercado Pago. En caso de que no las encuentres, asegúrate de revisar tu carpeta de SPAM.

Puedes ver un ejemplo de cómo lucen estas notificaciones a continuación:

Para activar las notificaciones es necesario habilitar el canal de correo electrónico del integrador. Para hacerlo, puedes utilizar el siguiente comando:

curl --location --request PATCH 'https://api.mercadopago.com/point/integration-api/integrator' \
--h 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
        "event_channel_devices": [
                "email"
        ]
}'

Una vez configurado el canal por el que se recibirán las notificaciones, puedes consultar su estado ejecutando el siguiente comando:

curl --location --request GET 'https://api.mercadopago.com/point/integration-api/integrator' \
--h 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Recibirás una respuesta similar a la siguiente:

{
  "id": 1234567890,
  "created_at": "0001-01-01T00:00:00Z",
  "updated_at": "0002-02-02T00:00:00Z",
  "notification_url_enabled": true,
  "event_channel_devices": [
    "email"
  ]
}