O banco 481 SUPERLOGICA SCD 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.
• Lista de Bancos, Agência e Conta para Verificação de Conta e Domicílio Bancário

Agora é possível fazer Split por Assinaturas!

Anteriormente, a funcionalidade de Splits era limitada ao endpoint de criação de faturas (POST /v1/invoices), permitindo regras variáveis de Split apenas nesse contexto. Com a nova atualização, o Split por Assinaturas foi introduzido, ampliando as possibilidades para usuários que utilizam o endpoint de criação de assinaturas (POST /v1/subscriptions). Essa melhoria permite a configuração direta do objeto splits durante a criação de uma assinatura.

O que muda na prática?

Agora, ao criar uma assinatura, é possível definir regras personalizadas de divisão de valores (Split) diretamente no momento da requisição. Isso oferece maior flexibilidade e automação na gestão de receitas, especialmente para negócios que dependem de repasses para diferentes contas.

Assim, as mesmas possibilidades já existentes para faturas estão disponíveis para assinaturas, promovendo um alinhamento entre as duas funcionalidades.

Exemplo de Requisição

Veja abaixo um exemplo prático de como configurar um Split durante a criação de uma assinatura:

curl --request POST \
     --url 'https://api.iugu.com/v1/subscriptions?api_token=seu-api_token' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "plan_identifier": "basic_plan",
  "customer_id": "282BF13F9DBF4D3D8C5D344FEA370F78",
  "splits": [
    {
      "recipient_account_id": "ID da Conta",
      "cents": 45
    }
  ]
}
'

Detalhamento do Payload:

Importante ⚠️

• Ao incluir regras de Split diretamente no payload da requisição de criação de assinaturas, as regras globais de Split configuradas na conta serão ignoradas. Nesse caso, as regras definidas no objeto splits prevalecerão.

Certifique-se de revisar a lógica de divisão antes de implementar essa funcionalidade para garantir que ela atenda às suas necessidades específicas.

Essa novidade traz mais flexibilidade para adaptar os processos de divisão de receitas às exigências do seu modelo de negócio!

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.

Agora há uma seção especialmente para BaaS nos Diagramas de Sequência de chamada às APIs

São elas:

• Criar e Verificar Conta iugu
• Depósito — PIX
• Pagar um Boleto
• PIX/TED Out

Não é só isso...🚧

Ainda serão criados novos diagramas. #staytuned

O endpoint que lista os API Tokens de uma conta foi descontinuado

A partir de hoje (18), o endpoint GET /v1/{account_id}/api_tokens não está mais disponível para utilização. Esta é mais uma medida de segurança que adotamos para manter a integridade das Contas iugu.

Acessar api_token

Os tokens são disponibilizados durante a criação de uma subconta ou criação via Alia. Guarde-os em um local seguro para todas as outras requisições às nossas APIs.

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:

• 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.

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:

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 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:

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.

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:

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