Webhooks de Abertura de Conta
Após a solicitação de reserva de conta, é emitido um webhook do tipo account_request.status_change com o status pending_additional_data. Este evento serve como gatilho para que uma requisição de confirmação da abertura de conta seja enviada.
Na resposta síncrona à solicitação de abertura, o sistema retornará o status pending_kyc_analysis. Nesse estágio, a decisão sobre a aprovação ou rejeição da abertura da conta será comunicada de forma assíncrona através de um webhook.
É importante notar que, embora o número da conta seja reservado imediatamente após a solicitação, a conta ainda não estará oficialmente aberta. A abertura efetiva só ocorrerá após a conclusão bem-sucedida da análise de KYC (Conheça Seu Cliente) realizada pela QI Tech.
Status da solicitação de abertura de conta
Pendente
WEBHOOK_TYPE
account_request.status_changeSTATUS
pending_additional_dataWebhook Body
{
"key": "e8e9e118-45e7-4659-aaaa-0677c0e2e4dc",
"data": {
"account_info": {
"account_digit": "7",
"account_branch": "0001",
"account_number": "6694401"
},
"account_request_key": "e8e9e118-45e7-4659-aaaa-0677c0e2e4dc"
},
"status": "pending_additional_data",
"webhook_type": "account_request.status_change",
"event_datetime": "2025-01-19T14:18:25.409670"
}
Rejeitada
WEBHOOK_TYPE
account_request.status_changeSTATUS
rejectedWebhook Body
{
"key": "e8e9e118-45e7-4659-aaaa-0677c0e2e4dc",
"data": {
"account_info": {
"account_digit": "1",
"account_branch": "0001",
"account_number": "4456617"
},
"account_request_key": "e8e9e118-45e7-4659-aaaa-0677c0e2e4dc"
},
"status": "rejected",
"webhook_type": "account_request.status_change",
"event_datetime": "2025-01-19T14:18:25.409670"
}
Webhook Body Param
Campo | Tipo | Descrição | Máx. Caracteres |
---|---|---|---|
key | uuidv4 | Chave originadora | 36 |
data | object | Dados da requisição de abertura de conta | Objeto data |
status | enumerator | Status de abertura da conta | Enumeradores account_request_status |
webhook_type | string | Identificador do tipo de evento sendo reportado | 23 |
event_datetime | string | Data e hora do envio do webhook | 20 |
Objeto data
Campo | Tipo | Descrição | Máx. Caracteres |
---|---|---|---|
account_request_key | uuidv4 | Chave da reserva de abertura de conta | 36 |
account_info | object | Dados da conta | Objeto account_info |
Objeto account_info
Campo | Tipo | Descrição | Máx. Caracteres |
---|---|---|---|
account_branch | string | Agência da conta | 4 |
account_digit | string | Dígito da conta | 1 |
account_number | string | Número da conta | 20 |
Enumeradores account_request_status
Enumerador | Descrição |
---|---|
pending_additional_data | Pendente de informações adicionais |
rejected | Abertura rejeitada |