📘

O que você irá aprender com esse artigo?

• Criar Subconta
• Configuração de Split por conta
• Configuração de subconta
• Verificação da subconta
• Faturar na subconta
• Atualizar Subconta
• Informações da conta
• Habilitar métodos de pagamento

Criar Subconta

🚧

Atenção

Não é possível criar subconta no ambiente de teste, pois na iugu só existe uma única conta, de produção. O que pode ser feito é criar a subconta de produção e utilizar ela no ambiente de teste, conforme passo 1.

Antes de passar os detalhes da criação da subconta, são necessários alguns esclarecimentos sobre split de pagamento. Na iugu, existe o split por conta e o split por fatura.

Configuração de Split por conta

Esse split é usado quando o recebimento das contas envolvidas é padrão (não muda) ou quando o modelo de negócio diz respeito ao uso de assinaturas. Basicamente, a definição de split na subconta envia os valores automaticamente para as contas informadas no split.

Exemplo: Supondo que eu tenha um modelo de negócio do tipo mobilidade urbana, onde minha subconta é o motorista e a conta mestre é a minha plataforma. Ainda nesse cenário, suponha que o motorista sempre recebe 90% da transação (que é a corrida) e a conta Mestre fica com os 10% restantes. Sendo assim, na criação da subconta do Motorista é possível informar um split de 10% para a conta Mestre, onde tudo que for criado sob a conta dele será enviado para a conta principal.

Split por conta no painel x Split por conta na API

Via painel: só é possível definir o recebimento da conta Mestre. Isso significa que se uma subconta for criada pelo painel, só é possível definir o valor do split que ela vai passar para a conta Mestre.

Via API: assim como no painel, é possível definir qual parte do recebimento dessa subconta será direcionado para a conta Mestre. Porém, é possível definir outra subconta como recebedora e ainda é possível definir mais de uma conta para o split.

Mais detalhes sobre split por conta aqui.

Criação da Subconta

A subconta pode ser criada via painel iugu, veja como realizar aqui. Ela também pode ser criada via API e a vantagem de seguir esse fluxo é que os tokens de API já são gerados automaticamente. Veja como criar via API clicando aqui. API para Criar Subconta.

Exemplo de retorno da criação:

{
"account_id": "444444440BC64B6EB42DEC9CCCCCCCCC",
"name": "Subconta",
"live_api_token": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA111111111111111111111111111111111",
"test_api_token": "AAAAAAAAAAAAAAAAAAAAAA111111111111111111111111111111111AAAAAAAAA",
"user_token": "111111111111111111111111111111111AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
}

Configuração da subconta

Depois de criada, é possível configurar alguns detalhes da subconta na chamada de Configurar conta.

Configurações possíveis:

• Habilitar/Desabilitar saque automático
• Definir multas, juros e descontos padrão da conta
• Habilitar/Desabilitar antecipação automática
• Habilitar/Desabilitar pagamentos por boleto
  - Definir dias de vencimento extras
  - Definir dias de vencimento extras para 2ª via do boleto
• Habilitar/Desabilitar pagamentos por cartão
  - Descrição da fatura no cartão de crédito do cliente
  - Habilitar/Desabilitar parcelamento
  - Definir número máximo de parcelas
  - Habilitar cobrança em duas etapas
• Habilitar/Desabilitar avisos de email
• Desabilitar saque da conta
• Configurar saldo mínimo (caso saque automático seja habilitado)

Verificação da subconta

A API de Verificação da subconta é um passo obrigatório para que consiga transacionar através dela. Basicamente, é nessa chamada que é definido o titular dessa conta (pessoa física ou jurídica), além da definição dos dados bancários para realização dos saques. Essa etapa é sistémica, ou seja, enviando todos os campos obrigatórios a subconta já retorna verificada. Os dados que devem ser enviados são:

• Valor máximo da venda
• Se o produto vendido é físico
• Descrição do negócio
• Tipo de pessoa (Física ou Jurídica)
• Habilitar/Desabilitar saque automático
• Documento do titular (CPF ou CNPJ)
• Nome da Pessoa ou Companhia (titular do documento)
• Endereço e telefone do titular da conta
• Nome e CPF do responsável, caso informado Pessoa Jurídica
• Dados bancários: devem ser do mesmo titular da conta (mesmo CPF ou CPNJ)

Para mais detalhes sobre criação e configuração da subconta, clique aqui.

Faturar na subconta

Para faturar na subconta, ou seja, criar faturas/assinaturas com a subconta, basta utilizar o token (de teste ou produção) da subconta como autenticador na API de criar faturas.

Atualizar subconta

Algumas informações referentes a subconta podem ser configuradas e atualizadas na chamada de Atualizar conta.
Dados como:

• Nome
• Dias de faturamento padrão para a assinatura
• Url padrão para redirecionamento após pagamento no link da iugu
• Lista de emails que devem receber notificações (apenas usuário administrador)
• Email para resposta dos clientes

Informações da conta

Há uma API que permite consultar todas as informações da conta. Ela é utilizada para consultar saldo disponível para saque, se a conta está verificada, dados do titular da conta, conta bancária vinculada, entre outras informações. Para essa consulta, basta informar o id da conta e realizar um GET na chamada de Informações da conta.

Habilitar métodos de pagamento

Para habilitar boleto e cartão de crédito, basta consultar o menu de Configuração da subconta. No caso de PIX, deve ser habilitado na chamada de Configurar Pagamentos ou pelo painel, conforme tutorial clicando aqui.