Notificações
Postbacks/Webhooks/Callbacks
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 |
Updated 5 months ago