Notificações de transações

Notificações de transações

O Padmoney oferece notificações de transações para permitir que seu sistema seja avisado automaticamente sempre que ocorrer uma mudança no status de alguma transação destinada a sua conta.

Configurando o recebimento de notificações

A configuração do recebimento de notificações é realizada nas configurações de sua conta no Padmoney, onde será possível informar a URL de Notificação além de gerar e recuperar o Código de Notificação notification-code e o Tipo de Notificação notification-type.

Recebendo uma notificação

O Padmoney enviará as notificações para a URL de Notificação que configurada usando o protocolo HTTPS, pelo método POST.

Além dos cabeçalhos normais de uma requisição HTTPS POST, os seguintes cabeçalhos são enviados:

Cabeçalho Obrigatório Descrição
notification-type Sim Tipo de notificação
notification-code Sim Token de segurança, para validar requisição pertencente ao Padmoney

retorno

{
  "request_id": "cc7cefb4-cc82-4683-9e57-6c4de1e3a962",
  "date": "2018-01-01T08:42:00.000-03:00",
  "bank_billets": [
    {
      "id": 1,
      "our_number": "000000000042-2",
      "barcode": "99999999999999999999999999999999999999999999",
      "identification_field": "99999999999999999999999999999999999999999999999",
      "status": "opened"
    },
    {
      "id": 2,
      "our_number": "000000000043-2",
      "barcode": "99999999999999999999999999999999999999999999",
      "identification_field": "99999999999999999999999999999999999999999999999",
      "status": "paid",
      "paid_amount": 1.99,
      "paid_at": "2018-01-01"
    }
  ]
}

Consulte aqui os possíveis valores para o campo status.

Definir URL de Notificações

POST /notifications

É possível também configurar a URL de notificação via API usando o método notifications.

Campo Obrigatório Tipo Tamanho Descrição
url Sim String   URL de notificação

Exemplo

Copy
{
  "url": "https://url.test/notifications"
}

Retorno

{
  "url": "https://url.test/notifications",
  "notification_type": "transaction",
  "notification_code": "D30F9238-A610-47FD-85A6-36311ABE187B"
}