Webhook for Pix Refunds

Webhook to notify about Pix refunds received for an Alias.

Webhook Request Body

Request Body: Pix received

{
  "webhook_type": "baas.pix_transfer.incoming_pix",
  "webhook_datetime": "2021-10-22T20:30:23.459Z",
  "data": {
    "pix_transfer_key": "8cb70dea-9fb0-4a68-9572-99a72849c8d6",
    "end_to_end_id": "E18236120202308111235s14fddf2801",
    "pix_transfer_status": "received",
    "account_key": "7c5a1425-73eb-420e-b4fb-0ce3386c7d0c",
    "alias_key": "fc6862c4-2b20-4057-8063-b8809866e494",
    "receiver_conciliation_id": "745c28c780bc4822bbade86dd875d10b",
    "transfer_amount": 126.97,
    "fee_amount": 0.0,
    "source_account": {
      "account_branch": "0001",
      "account_digit": "3",
      "account_number": "12345678",
      "owner_document_number": "***02502000***",
      "owner_person_type": "legal",
      "owner_name": "Qi Tech",
      "account_type": "checking_account",
      "ispb": "32402502"
    },
    "pix_transfer_type": "reversal",
    "pix_message": "pix message received",
    "created_at": "2021-10-22T20:30:23.459Z",
    "reversals": [],
    "original_outgoing_pix_transfer": "b56862c4-2b20-4057-8063-b8809866e494"
  }
}

Webhook Body Param

Field	Type	Description	Max. Characters
webhook_type	string	An enumerator that defines the type of event being reported	23
webhook_datetime	string	Date and time the webhook was sent	20
pix_transfer_type	enumerator	Type of the pix transaction performed	Enumerator pix_transfer_type
target_pix_key	string	Pix key of the account to which the transaction was sent	100
source_account	Object	Source account - Should only be sent for "manual" type transactions	Object source_account
transfer_amount	number	Transfer amount	10
receiver_conciliation_id	string	Reconciliation ID of the receiver	35
end_to_end_id	string	Idempotency key of a Pix transaction - should only be sent if the transfer type is "key"	32
pix_message	string	Message to be sent along with the Pix transfer	140
fee_amount	number	Transfer amount	10
pix_transfer_status	string	Status of the pix transaction	10
account_key	string	Unique identification key for the QI account	36
alias_key	string	Unique alias key	36
pix_transfer_key	string	Unique identification key for the Pix transfer	36
original_outgoing_pix_transfer	string	Unique identification key for the original outgoing Pix transfer	36

Enumerator pix_transfer_type

Enumerator	Description
manual	Pix using destination account details
key	Pix using a PIX key
static_qr_code	Pix using a static QR code
dynamic_qr_code	Pix using a dynamic QR code
reversal	Pix refund

Object source_account

Field	Type	Description	Characters
account_branch	string	Account branch	6
account_digit	string	Account digit	1
account_number	string	Account number	20
owner_document_number	string	CPF or CNPJ (numbers only) of the account holder	14
owner_name	string	Account holder's name	150
account_type	enumerator	Account type	Enumerator account_type
ispb	string	Eight-digit code that identifies banks in the Central Bank's reserve transfer system	8

Enumerator account_type

Enumerator	Description
checking_account	Checking Account
salary_account	Salary Account
saving_account	Savings Account
payment_account	Payment Account