Skip to main content

Webhook for Incoming Pix

Webhook to notify about Pix transactions 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": "dynamic_qr_code",
"pix_message": "pix message received",
"created_at": "2021-10-22T20:30:23.459Z",
"reversals": []
}
}

Webhook Body Param

FieldTypeDescriptionMax. Characters
webhook_typestringAn enumerator that defines the type of event being reported23
webhook_datetimestringDate and time the webhook was sent20
pix_transfer_typeenumeratorType of the pix transaction performedEnumerator pix_transfer_type
target_pix_keystringPix key of the account to which the transaction was sent100
source_accountObjectSource account - Should only be sent for "manual" type transactionsObject source_account
transfer_amountnumberTransfer amount10
receiver_conciliation_idstringReconciliation ID of the receiver35
end_to_end_idstringIdempotency key of a Pix transaction - should only be sent if the transfer type is "key"32
pix_messagestringMessage to be sent along with the Pix transfer140
fee_amountnumberTransfer amount10
pix_transfer_statusstringStatus of the pix transaction10
account_keystringUnique identification key for the QI account36
alias_keystringUnique alias key36
pix_transfer_keystringUnique identification key for the Pix transfer36

Enumerator pix_transfer_type

EnumeratorDescription
manualPix using destination account details
keyPix using a PIX key
static_qr_codePix using a static QR code
dynamic_qr_codePix using a dynamic QR code
reversalPix refund

Object source_account

FieldTypeDescriptionCharacters
account_branch *stringAccount branch6
account_digit *stringAccount digit1
account_number *stringAccount number20
owner_document_number *stringCPF or CNPJ (numbers only) of the account holder14
owner_namestringAccount holder's name150
account_type *enumeratorAccount typeEnumerator account_type
ispb *stringEight-digit code that identifies banks in the Central Bank's reserve transfer system8

Enumerator account_type

EnumeratorDescription
checking_accountChecking Account
salary_accountSalary Account
saving_accountSavings Account
payment_accountPayment Account