Account Opening Webhooks
After the account reservation request call, a webhook of type account_request.status_change is sent with the status pending_additional_data. This event serves as the trigger for sending the request to confirm account opening.
The account opening request response may return the status "pending_kyc_analysis" depending on the partner's integration configuration.
In this case, the response regarding account opening approval or rejection will be returned asynchronously via webhook.
The account number will be reserved at the moment of the opening request, however at this moment the account will not yet be open. Only after completion of QI Tech's KYC analysis will the account be open.
Webhook Pending KYC Analysis
After Bacen Protege+ approval, the account opening request status is updated to pending_kyc_analysis and a webhook is sent to notify the partner.
Webhook Body
{
"data": {
"account_info": {
"account_digit": "3",
"account_branch": "0001",
"account_number": "1638634"
},
"account_request_key": "dc575950-dcce-48e1-99a6-5fb0ada63d86",
"status": "pending_kyc_analysis"
},
"event_datetime": "2022-09-02 22:39:39",
"key": "dc575950-dcce-48e1-99a6-5fb0ada63d86",
"status": "pending_kyc_analysis",
"webhook_type": "account_request.status_change"
}
KYC Approval Webhook
Webhook Body
{
"data": {
"account_info": {
"account_digit": "3",
"account_branch": "0001",
"account_number": "1638634"
},
"account_request_key": "dc575950-dcce-48e1-99a6-5fb0ada63d86"
},
"event_datetime": "2022-09-02 22:39:39",
"key": "dc575950-dcce-48e1-99a6-5fb0ada63d86",
"status": "pending_additional_data",
"webhook_type": "account_request.status_change"
}
Account Request Status Enumerators
| Enum | Description |
|---|---|
| pending_kyc_analysis | Pending KYC approval |
| pending_additional_data | Pending additional information |
| rejected | Opening rejected |
Legal Entity Accounts
Account Rejected
Webhook Body
{
"data": {
"account_info": {
"account_digit": "2",
"account_branch": "0001",
"account_number": "2359934",
"financial_institution_code": "329"
},
"allowed_user": {
"name": "Juliana Tereza Bernardes",
"document_number": "97564480084"
},
"account_owner": {
"name": "VOVO LUCIA CONVENIENCIA LTDA",
"document_number": "09080702000105"
}
},
"event_datetime": "2022-09-02 22:39:39",
"key": "dc575950-dcce-48e1-99a6-5fb0ada63d86",
"status": "account_rejected",
"webhook_type": "account"
}
Individual Accounts
Account Rejected
Webhook Body
{
"key":"84864614-2860-4b78-bd44-77b961354014",
"data":{
"account_info":{
"account_key":"1435dbavf-2860-4b78-bd44-77b961354014",
"account_digit":"5",
"account_branch":"0001",
"account_number":"3998360",
"financial_institution_code":"329"
},
"account_owner":{
"name":"Pedro Pinho",
"document_number":"97634408077"
}
},
"status":"account_rejected",
"webhook_type":"account",
"event_datetime":"2024-01-09 14:35:46"
}