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",
    "request_control_key": "5ef0f67a-7672-4d00-8a02-faf847157c4b"
}

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",
    "request_control_key": "5ef0f67a-7672-4d00-8a02-faf847157c4b"
}

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
request_control_key	string	Identificador único por requisição do parceito	36

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