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
{
  "request_id": "cc7cefb4-cc82-4683-9e57-6c4de1e3a962",
  "date": "2018-01-01",
  "bank_billets": [
    {
      "id": "4a5918ec-baa7-4857-b829-961d2c1f890e",
      "our_number": "000000000042-2",
      "barcode": "999...99999",
      "identification_field": "9999...99999",
      "status": "opened"
    },
    {
      "id": "cad69779-4317-4d45-9d07-8e95d0252e37",
      "our_number": "000000000043-2",
      "barcode": "999...99999",
      "identification_field": "9999...99999",
      "status": "paid",
      "paid_amount": 1.99,
      "paid_at": "2018-01-01"
    }
  ]
}
{}

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
{
  "url": "https://url.test.com/notifications"
}
{
  "url": "https://url.test.com/notifications",
  "notification_type": "transaction",
  "notification_code": "D30F9238-A610-47FD-85A6-36311ABE187B"
}
{}
No body returned for response