Skip to main content

Webhooks de abertura de conta

Após a solicitação de reserva de conta, o status inicial é pending_bacen_validation. Se aprovada, o status da reserva é atualizado para pending_kyc_analysis. Em seguida, ao ser aprovado em KYC, o status se torna pending_additional_data.

Para os status pending_kyc_analysis, pending_additional_data e rejected, o webhook do tipo account_request.status_change é enviado, sendo esse evento essencial para controle das próximas ações necessárias à confirmação da abertura de conta.

O número de conta será reservado no momento da solicitação de reserva de abertura, porém neste momento a conta ainda não estará aberta. Somente após a conclusão da análise de KYC da QI Tech e posterior confirmação da solicitação pelo parceiro, a conta estará aberta.

Enumeradores account_request_status​

EnumDescription
pending_kyc_analysisPendente de aprovação KYC
pending_additional_dataPendente de informações adicionais
rejectedAbertura rejeitada

Webhook de pendência de análise de KYC​

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

Webhook de pendência de confirmação de conta​

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 de conta rejeitada (pessoa jurídica)​

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

Webhook de conta rejeitada (pessoa física)​

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