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

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

Rejected account webhook (individual)​

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