📘

O que você irá aprender com esse artigo?

• O que é uma transferência
• Transferência bancária (saque)
• Transferência entre contas

O que é uma transferência

A transferência é uma movimentação de valores de uma conta para outra. Na iugu nós temos dois tipos de transferências: bancária e entre contas iugu.

Transferência bancária (saque)

A transferência bancária, mais comumente chamada de saque, é a retirada de valores da conta iugu para uma conta bancária de mesmo titular.

🚧

Atenção!

Nesse momento não realizamos saques para contas de terceiro.

O saque é realizado em D+1, ou seja, no dia útil seguinte da solicitação, e o valor mínimo para sacar é de R$ 5,00. Se o saque for solicitado na sexta-feira, o valor só será realizado na segunda-feira, o mesmo não ocorre nos finais de semana e feriados, isso significa que só executamos em dias úteis.

O saque pode ter um custo e ele ocorre de acordo com o plano vinculado a conta, veja mais informações em: novo modelo de tarifas. Além disso, após a solicitação de saque o dinheiro passa para o campo “Em Trânsito”, para evitar que seja sacado suas vezes, e caso utilize gatilhos, a notificação referente a atualização do status de saque (withdraw_request.status_changed) será disparada no dia seguinte a compensação em seu domicílio bancário.

Para sacar o dinheiro é possível realizar uma chamada manual utilizando a API de Pedido de Saque ou o painel iugu. É possível ativar o saque automático no painel da iugu, conforme aqui.

Pela API basta realizar uma chamada do tipo POST informando o token_api e o id da conta que está solicitando o saque, informando também o valor a ser transferido.

Modelo de request

curl --location -g --request POST 'https://api.iugu.com/v1/accounts/{{id_account}}/request_withdraw' \ 
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{api_token in base64}}' \
--header 'Cookie: __cfruid=3308cef41f8f5a6c39491343b4721792bc8183e2-1634905517' \ 
--data-raw '{ 
    "amount": 500.0 
}'

Se utilizar vendas por cartão de crédito, é possível antecipar as parcelas para realizar o saque, veja como aqui.

Transferência entre contas iugu

O recurso de transferência entre contas iugu é muito utilizado no sistema de Marketplace e basicamente faz a movimentação de valores de uma conta iugu para outra conta iugu.

Essa transferência pode ser feita de subconta para outras subcontas e/ou para a conta mestre e pode ser feita da conta mestre para as sucontas.

A transferência entre contas não possui custo e o valor mínimo da solicitação é de 1 centavo. Nesse caso, a solicitação só está disponível pela API através da chamada Transferir Valor.

Modelo de request

curl --location --request POST 'https://api.iugu.com/v1/transfers' \ 
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{api_token in base64}}' \
--header 'Cookie: __cfruid=1b73fa0fcd5aaa5d72e58dee93da89e98d88de4a-1635344492' \ 
--data-raw '{ 
    "receiver_id": "{{id da conta de destino}}", 
    "amount_cents": 1000
}'