Skip to main content

Account Opening Webhooks

After the account reservation request call, a webhook of type account_request.status_change with the status pending_additional_data is sent. This event is the trigger for sending the request for account opening confirmation.

The response to the account opening request may return the status pending_kyc_analysis depending on the partner's integration configuration.

In this case, the approval or rejection response of the account opening will be returned asynchronously via webhook.

The account number will be reserved at the time of the opening request, but at this moment the account will not yet be opened. Only after the completion of QI Tech's KYC analysis will the account be opened.

This translation keeps the original context and details intact.

KYC Approval Webhook​

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

Enumerators account_request_status​

EnumDescription
pending_kyc_analysisPending KYC approval
pending_additional_dataPending additional information
rejectedOpening rejected

Corporate Accounts​

Corporate Account Opened Webhook​

WEBHOOK_TYPE
account
STATUS
account_opened
Webhook Body
{
	"data": {
		"account_info": {
			"account_key": "6d30a0b1-cb90-4ceb-b1ea-5bd600cdf3c8",
			"account_digit": "2",
			"account_branch": "0001",
			"account_number": "2359934",
			"financial_institution_code": "329"
		},
		"allowed_user": {
			"name": "Juliana Tereza Bernardes",
			"document_number": "12364480084"
		},
		"account_owner": {
			"name": "VOVO LUCIA CONVENIENCIA LTDA",
			"document_number": "12380702000105"
		}
	},
	"event_datetime": "2022-09-02 22:39:39",
	"key": "dc575950-dcce-48e1-99a6-5fb0ada63d86",
	"status": "account_opened",
	"webhook_type": "account"
}

Corporate Account Rejected Webhook​

WEBHOOK_TYPE
account
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"
}

Personal Accounts​

Personal Account Opened Webhook​

WEBHOOK_TYPE
account
STATUS
account_opened
Webhook Body
{
    "key":"b5978088-2860-4b78-bd44-77b961354014",
  	"data":{
        "account_info":{
            "account_key":"b7593804-2223-48b3-8a61-f48a651de1d4",
            "account_digit":"5",
            "account_branch":"0001",
            "account_number":"3998360",
            "financial_institution_code":"329"
        },
        "account_owner":{
            "name":"Pedro Pinho",
            "document_number":"97634408077"
        }
      },
    "status":"account_opened",
    "webhook_type":"account",
    "event_datetime":"2024-01-09 14:35:46"
}

Personal Account Rejected Webhook​

WEBHOOK_TYPE
account
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"
}