TransferĂȘncias

📘

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
}'