O parâmetro address_proof foi adicionado na Verificação de Subcontas!

A partir de agora, a verificação de subcontas exige um terceiro documento como parte do processo. Além dos parâmetros já existentes, identification e selfie, também será necessário enviar o parâmetro address_proof. Isso implica que a solicitação de verificação deve conter três arquivos obrigatórios.

Essa alteração impacta o endpoint:
POST /v1/accounts/{account_id}/request_verification

Para mais detalhes, consulte a documentação oficial do endpoint.


Exemplo de Requisição

curl --request POST \
     --url 'https://api.iugu.com/v1/accounts/5F0610FC05AA4EF391738124B312BBFA/request_verification?api_token=api_token-da-subconta' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "data": {
    "price_range": "Entre R$ 100,00 e R$ 500,00",
    "business_type": "Descrição do negócio",
    "person_type": "Pessoa Física",
    "cpf": "11343675030",
    "address": "Rua Principal",
    "cep": "13056-344",
    "city": "Cidade",
    "district": "Bairro",
    "state": "SP",
    "bank": "Santander",
    "bank_ag": "0000",
    "account_type": "Corrente",
    "bank_cc": "00000000-D"
  },
  "files": {
    "identification": "data:image/png;name=verificado.png;base64,(caracteres base64)",
    "selfie": "data:image/png;name=verificado.png;base64,(caracteres base64)",
    "address_proof": "data:image/png;name=verificado.png;base64,(caracteres base64)"
  }
}
'

Importante ⚠️

  • Obrigatoriedade dos Arquivos: Os três arquivos (identification, selfie e address_proof) são estritamente necessários para que a verificação seja processada. Qualquer ausência ou formato incorreto resultará em falha na solicitação.
  • Formato dos Arquivos: Certifique-se de que os documentos enviados estejam codificados em Base64 e atendam aos critérios de qualidade e legibilidade.

Essa atualização busca reforçar a segurança e a conformidade regulatória no processo de verificação de subcontas, garantindo maior proteção para os usuários e seus negócios.

Atualização na documentação: https://dev.iugu.com/reference/adicionar-domicilio-bancario , a quantidade de caracteres das contas das instituições de pagamentos "Stone e "FitBank".

Stone - 13 caracteres no parâmetro "account".
FitBank - 10 caracteres no parâmetro "account".

 '197':
    name: 'Stone'
    pattern:
      agency: '9999'
      account: '9999999999999'
      account_dvs: 'D'

  '450':
    name: 'FitBank'
    pattern:
      agency: '9999'
      account: '9999999999'
      account_dvs: 'D'

Separamos os Gatilhos por categoria

A fim de otimizar a visualização e organização das nossas páginas, separamos os gatilhos por categoria. São elas:


Em construção... 🚧

Ainda serão inseridos outros gatilhos que já existem, porém, com dados atualizados #staytuned.


Começa hoje!

Como compromisso com a segurança da sua conta, adicionamos +3 endpoints que obrigam a utilização de Assinatura RSA em suas requisições. São eles:

ReferênciaEndpoint
Criar Subconta/v1/marketplace/create_account
Configurar Conta/v1/accounts/configuration
Adicionar domicílio bancário/v1/bank_verification

Saiba mais sobre Assinatura RSA

O artigo Autenticação — Assinatura RSA aborda o assunto com um passo a passo detalhadamente descrito. Além disso, conta com a gravação do webinar, conduzido por um de nossos engenheiros. Veja:


Que tal uma Recipe? 🧪

Acesse esta recipe que sugere como o seu script pode ser desenvolvido (em Ruby) para este recurso: recipes/assinatura-rsa.


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 SubcontaPOST /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ênciaEndpointDescrição
Reenviar Documentos para Verificar Conta iuguPUT /v1/account/documentsUtilize 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 iuguGET /v1/account/documentsPermite 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âmetroDescriçãoExemplo
eventNome do Eventoreferrals.verification
data[status]Aprovação ou Reprovaçãoaccepted ou rejected
data[account_id]ID da ContaA123B4C5D6789E2F5G6H7I8J9K8L9M8N8O8
data[id]ID da Verificação-
data[feedback]Se rejected: mensagem do Time de Prevenção à Fraude-

A partir do dia 07/11/2024 +3 rotas entram na lista de obrigatoriedade

Foram adicionados os parâmetros Signature e Request-Time no header dos endpoints:

APIEndpoint
Criar Subcontav1/marketplace/create_account
Configurar Contav1/accounts/configuration
Adicionar Domicílio Bancáriov1/bank_verification

Saiba mais sobre RSA

Consulte o guia completo de RSA em Autenticação — Assinatura RSA.


Recipe 🧪

Além do artigo completo, veja, na prática (em Ruby), uma sugestão de como escrever seu script para RSA: recipes/rsa-assinatura-rsa


Agora as Subcontas iugu deverão enviar arquivos para se tornarem verificadas

Para atender as exigências do BACEN, foram adicionados novos parâmetros ao endpoint Enviar Verificação de SubcontaPOST /v1/accounts/{account_id}/request_verification. São eles:

Objeto files

Arquivos (codificados em Base64 e com limite de 15 MB por arquivo) para KYC, como Foto do Documento de Identificação Pessoal, selfie etc.

ParâmetroDescriçãoObrigatório
identificationDocumento de Identificação Pessoal do Titular (RG, CNH ou Passaporte) detentor dos dados informados no objeto data
selfieFoto (selfie) do titular da Conta
balance_sheetRelatório financeiro da CompanhiaSe person_type é Pessoa Jurídica
social_contractContrato SocialSe person_type é Pessoa Jurídica
additional_document_oneDocumento adicional 1
additional_document_twoDocumento adicional 2

📘

Dica

Na referência da API Enviar Verificação de Subconta, o arquivo é codificado para Base64 automaticamente.

KYC

A conta não será verificada após esta chamada. O prazo para torná-la verified é de até 2 dias úteis.

Verificar status

Utilize o endpoint Informações da ContaGET /v1/accounts/{id} e confira a propriedade is_verified?. Se true, então, a conta está verificada.


Recipe 🧪

Foi criada, também, uma recipe que aborda, na prática, cada chamada para Verificar uma Subconta iugu: recipes/verificar-subconta-iugu-novo

Conteúdo teórico 📖

Saiba mais sobre Verificar subcontas iugu em Criar, Verificar e Configurar Subconta.


As APIs de Convite de Usuário foram desativadas

Estes endpoints eram responsáveis por gerir os convites de usuários que permitiam acesso ao Alia:

APIEndpoint
Criar ConvitePOST /{account_id}/user_invites
Cancelar ConvitePUT /{account_id}/user_invites/{id}/cancel
Reenviar ConvitePOST /{account_id}/user_invites/{id}/resend
Buscar ConviteGET /{account_id}/user_invites/{id}
Listar ConvitesGET /{account_id}/user_invites

E agora?

Para convidar um usuário para acessar o seu Painel, utilize o próprio Painel. Confira o artigo Como cadastrar outros logins de usuários com permissões de acesso diferentes?.