Skip to main content

Account opening webhooks

After the account reservation request, the initial status is pending_bacen_validation. If approved, the reservation status is updated to pending_kyc_analysis. Then, upon KYC approval, the status becomes pending_additional_data.

For the status pending_kyc_analysis, pending_additional_data and rejected, the webhook of type account_request.status_change is sent, being this event essential for controlling the next actions necessary for account opening confirmation.

The account number will be reserved at the time of the opening reservation request, however at this moment the account will not yet be open. Only after completion of QI Tech's KYC analysis and subsequent confirmation of the request by the partner, the account will be open.

account_request_status enumerators​

EnumDescription
pending_kyc_analysisPending KYC approval
pending_additional_dataPending additional information
rejectedOpening rejected

When the status is rejected, the webhook includes the rejection_reason field in the root of the message. The value of this field is free-form and returned directly from the KYC analysis, and may vary according to the reason identified, whether from KYC analysis or from Bacen Protege+.

KYC analysis pending webhook​

WEBHOOK_TYPE
account_request.status_change
STATUS
pending_kyc_analysis
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"
}

Account confirmation pending webhook​

WEBHOOK_TYPE
account_request.status_change
STATUS
pending_additional_data
Webhook Body
{
    "key": "dc575950-dcce-48e1-99a6-5fb0ada63d86",
    "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",
    "status": "pending_additional_data",
    "webhook_type": "account_request.status_change"
}

Rejected account opening webhook (KYC)​

WEBHOOK_TYPE
account_request.status_change
STATUS
rejected
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-02T22:39:39",
    "key": "dc575950-dcce-48e1-99a6-5fb0ada63d86",
    "status": "rejected",
    "webhook_type": "account_request.status_change",
    "rejection_reason": "UNSC"
}

Rejected account opening webhook (Bacen Protege+)​

WEBHOOK_TYPE
account_request.status_change
STATUS
rejected
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-02T22:39:39",
    "key": "dc575950-dcce-48e1-99a6-5fb0ada63d86",
    "status": "rejected",
    "webhook_type": "account_request.status_change",
    "rejection_reason": "Rejeitado devido ao Bacen Protege+"
}