Notificações

Um postback é um método de comunicação entre sistemas que permite que uma aplicação web envie automaticamente informações para outra aplicação quando ocorre um evento específico.

Basicamente, o postback é um mecanismo de comunicação entre duas partes: um sistema de origem e um sistema receptor. No contexto dos Produtos BaaS, o postback é comumente utilizado para rastrear e informar o início e andamento (evolução de status) das transações.

Quando um usuário realiza uma ação desejada, como o pagamento de um QR Code PIX, o sistema de origem envia uma notificação para o sistema receptor através do postback. Essa notificação contém informações relevantes sobre a ação realizada, como o ID da transação, o valor e outros dados importantes.

O sistema receptor, ao receber o postback, processa essas informações e realiza as devidas ações, como atualizar o status da transação, registrar os dados do cliente e gerar relatórios de desempenho. Dessa forma, o postback permite que as informações sejam transmitidas em tempo real, garantindo uma análise precisa e atualizada das transações.

Abaixo um dos modelos de postbacks disponíveis nas Plataformas de BaaS:

PIX IN - Pagamento de QR Code

{
  "id": "b3f030e1-f905-4c8e-a926-6fb08c57c49b",
  "type": "deposit",
  "amount": "0.05",
  "source": {
    "ispb": "18236120",
    "name": "Fulano Fulano",
    "type": "personal",
    "taxId": "12121212121",
    "taxIdHash": "f673e952d3315506816030a31f6fd207ef40516679e29e333ae92e3ea6a586ef"
  },
  "states": [
    {
      "id": "13de778a-098c-4f59-87fc-1d5e2b78b58a",
      "status": "success",
      "createdAt": "2024-03-06T00:02:12.459Z",
      "additionalData": {}
    },
    {
      "id": "14dbe662-3168-48ea-9c90-14a8c9b8bc8d",
      "status": "pending",
      "createdAt": "2024-03-06T00:02:12.452Z",
      "additionalData": {}
    }
  ],
  "status": "success",
  "wallet": {
    "id": "22955a54-5252-40b7-927f-44a9ed7f52ad",
    "ispb": "03311443",
    "status": "ready",
    "clientId": "66b7be28-33d1-44a5-b56d-9ce6ce6cc80b",
    "accountId": "baf0a04f-4185-4819-b41b-7bd21ceff131",
    "createdAt": "2022-08-26T15:21:36.272Z",
    "bankBranch": "0001",
    "bankNumber": "10000000091"
  },
  "walletId": "22955a54-5252-40b7-927f-44a9ed7f52ad",
  "createdAt": "2024-03-06T00:02:12.452Z",
  "endToEndId": "E18236120202403060001s018c1248e1",
  "destination": {
    "ispb": "03311443",
    "type": "corporate",
    "taxId": "29079725000107"
  },
  "additionalData": {
    "customID": "Teste Pix-Cob",
    "externalCustomerName": "BETBET"
  },
  "clientExternalId": "KAIf57963721dd34dfdaa8843c069ff1535",
  "initiationMethod": "QRDN"
}

Descrição dos campos:

Campo	Descrição
type	- Tipo de transação: - deposit (PIX IN) - withdraw (PIX OUT) - deposit_refund (Refund IN) - withdraw_refund (Refund OUT)
source	- Referente aos dados do pagador do QR Code
states	- Referente ao histórico de status da transação (success)
wallet	- Referente aos dados da conta origem do QR Code
endToEndId	- ID principal da transação de PIX
destination	- Referente aos dados da wallet que recebeu o PIX IN
clientExternalId	- Código de identificação do QR Code
initiationMethod	- Tipo de PIX IN, QR Code = QRDN