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
}'
Updated over 1 year ago