---
updatedAt: 2025-10-31T16:44:46.000Z
agentTools:
  projectIndex: https://dev.iugu.com/llms.txt
---

# KYC — Verificação de Conta iugu

Confira os eventos acionados por verificação de contas e os dados enviados.

# Verificação de afiliados/Verificação de Subconta iugu

Acionado sempre que há o envio de Verificação de Subconta.

| Parâmetro                   | Descrição                                                             | Exemplo                                            |
| :-------------------------- | :-------------------------------------------------------------------- | :------------------------------------------------- |
| event                       | Nome do Evento                                                        | `referrals.verification`                           |
| data\[id]                   | ID da Verificação                                                     | `4857E1D7FD5E410A9C563024250015TC`                 |
| data\[account\_id]          | ID da Conta que enviou a Verificação                                  | `70CA234077134ED0BF2E0E46B0EDC36F`                 |
| data\[status]               | Status da Verificação                                                 | `accepted` ou `rejected`                           |
| data\[feedback]             | Mensagem de Rejeição (somente quando a verificação for **rejeitada**) | Mensagem fornecida pelo Time de Prevenção à Fraude |
| data\[charge\_limit\_cents] | Limite da Conta em centavos (caso seja verificada)                    | `5000`                                             |

***

# Verificação bancária de afiliados/subconta iugu

Acionada **sempre** que há uma mudança no Domicílio Bancário de uma subconta.

| Parâmetro          | Descrição             | Exemplo                            |
| :----------------- | :-------------------- | :--------------------------------- |
| event              | Nome do Evento        | `referrals.bank_verification`      |
| data\[id]          | ID da Verificação     | `4857E1D7FD5E410A9C563024250015TC` |
| data\[account\_id] | ID da Conta           | `70CA234077134ED0BF2E0E46B0EDC36F` |
| data\[status]      | Status da Verificação | `accepted` ou `rejected`           |

***

# Verificação de documentos de afiliados/subconta iugu

Acionado **sempre** que o status de verificação dos documentos de uma subconta é **alterado**.

| Parâmetro             | Descrição                     | Exemplo                                                                                                                                                        |
| :-------------------- | :---------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| event                 | Nome do Evento                | `referrals.document_status_change`                                                                                                                             |
| data\[status]         | Status do arquivo             | `requested` ou `approved`.                                                                                                                                     |
| data\[account\_id]    | ID da Conta                   | `70CA234077134ED0BF2E0E46B0EDC36F`                                                                                                                             |
| data\[document\_type] | Tipo do Documento             | `identification`, `selfie`, `balance_sheet`, `social_contract`, `additiconal_document_one`, `additiconal_document_two`                                         |
| data\[reason]         | Motivo da recusa do Documento | A selfie recebida está ilegível                                                                                                                                |
| data\[reason\_code]   | Motivo da recusa em código    | PF-SELFIE-ILEGIVEL (Consulte a lista completa de códigos, com a mensagem e a ação correspondente a cada um, em [Reenvio de Documentos: Códigos e Mensagens)]() |

Significados dos status

### `referrals.verification`

* `accepted`: Conta aceita e **Verificada**. Apta a transacionar.
* `rejected`: Conta recusada e **Não verificada**. Não autorizada à transacionar.

### `referrals.bank_verification`

* `accepted`: Alteração de Domicílio Bancário **aceita**.
* `rejected`: Alteração de Domicílio Bancário **recusada**.

### `referrals.document_status_change`

* `requested`: Documento **recusado** e reenvio solicitado. Utilize o endpoint para [Reenviar Documentos para Verificar Conta iugu](https://dev.iugu.com/reference/reenviar-documentos).
* `approved`: Documento **aprovado** (Enviado apenas quando a análise é feita de forma manual).