Passo 2: Criação e configuração de Subcontas
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.
Updated 10 months ago