Pular para o conteúdo principal

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_change
STATUS
pending_additional_data
Webhook 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_change
STATUS
rejected
Webhook 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

CampoTipoDescriçãoMáx. Caracteres
keyuuidv4Chave originadora36
dataobjectDados da requisição de abertura de contaObjeto data
statusenumeratorStatus de abertura da contaEnumeradores account_request_status
webhook_typestringIdentificador do tipo de evento sendo reportado23
event_datetimestringData e hora do envio do webhook20

Objeto data

CampoTipoDescriçãoMáx. Caracteres
account_request_keyuuidv4Chave da reserva de abertura de conta36
account_infoobjectDados da contaObjeto account_info

Objeto account_info

CampoTipoDescriçãoMáx. Caracteres
account_branchstringAgência da conta4
account_digitstringDígito da conta1
account_numberstringNúmero da conta20

Enumeradores account_request_status

EnumeradorDescrição
pending_additional_dataPendente de informações adicionais
rejectedAbertura rejeitada