Pular para o conteúdo principal

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

Quando o status for rejected, o webhook inclui o campo rejection_reason no corpo raiz da mensagem. O valor desse campo é livre e pode variar conforme a razão identificada, seja proveniente da análise de KYC ou do Bacen Protege+.

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 abertura rejeitada (KYC)​

WEBHOOK_TYPE
account_request.status_change
STATUS
rejected
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-02T22:39:39",
    "key": "dc575950-dcce-48e1-99a6-5fb0ada63d86",
    "status": "rejected",
    "webhook_type": "account_request.status_change",
    "rejection_reason": "UNSC"
}

Webhook de abertura rejeitada (Bacen Protege+)​

WEBHOOK_TYPE
account_request.status_change
STATUS
rejected
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-02T22:39:39",
    "key": "dc575950-dcce-48e1-99a6-5fb0ada63d86",
    "status": "rejected",
    "webhook_type": "account_request.status_change",
    "rejection_reason": "Rejeitado devido ao Bacen Protege+"
}