Configurar notificações

Se você desejar, pode receber notificações de Webhooks. Elas são enviadas da nossa API de Integrações para o seu sistema receptor por meio de uma chamada HTTP POST, e alertam sobre todas as mudanças relacionadas aos estados das intenções de pagamento.

Para integrá-las, siga as instruções na documentação sobre notificações de Webhook. Você precisará ativar os eventos de Integrações Point para receber essas atualizações.

Depois de implementar as notificações e fazer os ajustes necessários, elas terão o seguinte formato:

Status final de uma intenção de pagamento quando a transação termina.

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

Ocorre quando a intenção de pagamento concluiu sem receber um status de pagamento. Uma vez obtido, esse status não mudará. Ao recebê-lo, você deve confirmar em seu dispositivo qual é o status do pagamento, usando o payment_id recebido na resposta, antes de entregar seu produto ou serviço.

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

Status final de uma intenção de pagamento quando ela é cancelada.

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

Status final de uma intenção de pagamento quando ocorre um erro de transação.

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

Você pode receber notificações sobre eventos gerados por cada um de seus dispositivos point, desta forma você conseguirá ter controle e monitoramento de seus dispositivos. Essas notificações podem ser causadas por:

• Terminal reinicia.
• Logouts.
• Mudança no modo de operação de PDV para STANDALONE ou vice-versa.

As notificações chegarão ao seu e-mail cadastrado no MercadoPago. Caso não encontre verifique sua pasta de SPAM.

Você pode ver um exemplo dessas notificações abaixo:

Para ativar as notificações é necessário habilitar o canal de e-mail do integrador. Para faze-lo, você pode usar o seguinte 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"
        ]
}'

Uma vez configurado o canal de notificação, você pode verificar seu status executando o seguinte comando:

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

A resposta será semelhante a isso:

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