DESCONTINUADO
ATENÇÃO! O EndPoint - Listar API Tokens - GET https://api.iugu.com/v1/{account_id}/api_tokens foi descontinuado.
EndPoint que listava a API TOKEN de uma determinada subconta.
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'
13/11/24 — Reformulação da página de Gatilhos
by Karthen JúniorSeparamos 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:
- Fatura
- Assinatura
- PIX/TED Out — Transferência para Terceiros
- Depósito
- KYC — Verificação de Conta iugu
- Método de Pagamento de Cliente
- Antecipação de Recebíveis
- Pedido de Pagamento — Pagamento de Boletos via Conta iugu
Em construção... 🚧
Ainda serão inseridos outros gatilhos que já existem, porém, com dados atualizados #staytuned
.
07/11/24 — RSA — +3 endpoints obrigatórios
by Karthen JúniorComeç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ência | Endpoint |
---|---|
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.
06/11/24 — KYC de Subconta — +2 Novos endpoints e +1 Gatilho
by Karthen JúniorAgora é 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á-losObs.: 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 | - |
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:
API | Endpoint |
---|---|
Criar Subconta | v1/marketplace/create_account |
Configurar Conta | v1/accounts/configuration |
Adicionar Domicílio Bancário | v1/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
28/10/24 — KYC de Subconta
by Karthen JúniorAgora 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 Subconta — POST
/v1/accounts/{account_id}/request_verification
. São eles:
Objeto files
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âmetro | Descrição | Obrigatório |
---|---|---|
identification | Documento de Identificação Pessoal do Titular (RG, CNH ou Passaporte) detentor dos dados informados no objeto data | ✅ |
selfie | Foto (selfie) do titular da Conta | ✅ |
balance_sheet | Relatório financeiro da Companhia | Se person_type é Pessoa Jurídica |
social_contract | Contrato Social | Se person_type é Pessoa Jurídica |
additional_document_one | Documento adicional 1 | ❌ |
additional_document_two | Documento 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 Conta —
GET
/v1/accounts/{id}
e confira a propriedadeis_verified?
. Setrue
, 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.
25/10/24 — Endpoint /user_invites depreciado
by Karthen JúniorAs 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:
API | Endpoint |
---|---|
Criar Convite | POST /{account_id}/user_invites |
Cancelar Convite | PUT /{account_id}/user_invites/{id}/cancel |
Reenviar Convite | POST /{account_id}/user_invites/{id}/resend |
Buscar Convite | GET /{account_id}/user_invites/{id} |
Listar Convites | GET /{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?.
O banco 526 MONETARIE SOCIEDADE DE CRÉDITO DIRETO S.A foi incluído como domicílio bancário!
Endpoints atualizados
Os endpoints que receberam esta atualização foram:
- Enviar Verificação de Subconta —
v1/accounts/{account_id}/request_verification
. - Adicionar Domicílio Bancário —
v1/bank_verification
.