06/11/24 — KYC de Subconta — +2 Novos endpoints e +1 Gatilho

Agora é possível reenviar documentos para KYC, consultar o status de análise e receber notificação via gatilho!

Recentemente adicionamos o objeto files ao endpoint Enviar Verificação de Subconta — POST /v1/accounts/{account_id}/request_verification que permite enviar arquivos que compõem o processo de KYC de contas bancárias.

A fim de complementar este objeto subimos

2 novos endpoints:

Referência	Endpoint	Descrição
Reenviar Documentos para Verificar Conta iugu	`PUT` `/v1/account/documents`	Utilize este endpoint quando os Documentos enviados pelo `/v1/accounts/{account_id}/request_verification` são reprovados ou deseja alterá-los Obs.:Para alteração,antes* certifique-se que seu status seja `pending_manual_analysis`.
Consultar Envio de Documentos para Verificação de Conta iugu	`GET` `/v1/account/documents`	Permite consultar o status do Envio de Documentos para Verificação de Subconta.

Referência

Endpoint

Descrição

Reenviar Documentos para Verificar Conta iugu

PUT /v1/account/documents

Utilize este endpoint quando os Documentos enviados pelo /v1/accounts/{account_id}/request_verification são reprovados ou deseja alterá-los

*Obs.:**Para alteração,**antes** certifique-se que seu status seja pending_manual_analysis.

Consultar Envio de Documentos para Verificação de Conta iugu

GET /v1/account/documents

Permite consultar o status do Envio de Documentos para Verificação de Subconta.

1 Gatilho

Este gatilho é acionado sempre que o resultado da análise da Conta iugu, realizada pelo Time de Prevenção à Fraude, é aprovada ou reprovada.

Parâmetro	Descrição	Exemplo
event	Nome do Evento	`referrals.verification`
data[status]	Aprovação ou Reprovação	`accepted` ou `rejected`
data[account_id]	ID da Conta	`A123B4C5D6789E2F5G6H7I8J9K8L9M8N8O8`
data[id]	ID da Verificação	-
data[feedback]	Se `rejected`: mensagem do Time de Prevenção à Fraude	-