Cashback como resgate
O que você irá aprender com esse artigo?
- O que é cashback com resgate
- Como usar o cashback como resgate
Caso de uso
Criei um produto com cashback e quero enviar o dinheiro para a conta corrente do cliente.
Diagrama de sequência

O que é cashback com resgate
A forma mais tradicional de cashback é devolver uma parte do valor pago pelo cliente para sua conta bancária. Isso significa que, se utilizar o cashback como resgate de valor, será necessário realizar uma transferência bancária do valor que está na subconta para a conta corrente do cliente, ou seja, um saque. Para saber mais sobre o que é cashback acesse aqui.
Como usar o cashback como resgate
Após realizado a cobrança do cliente, será necessário devolver o valor de cashback para ele. Porém, existem algumas regras que devem ser seguidas para entender como e quando pode ser realizado o saque, sendo elas:
Cartão de Crédito
Vai depender do modelo de negócio do Marketplace (conta mestre). Segue algumas opções:
Trabalhar com a configuração de antecipação automática
Nesse modelo o valor é disponibilizado rapidamente na conta iugu de acordo com o configurado na plataforma, porém só é possível antecipar a transação inteira, e o valor mínimo para realizar a antecipação automática é 1 dia útil.
Para mais informações sobre antecipação automática recomendamos a leitura do artigo nesse link.
Trabalhar com a disponibilização de acordo com compensação do cartão de crédito
Para esse modelo o cliente deve ser informado que o valor só fica disponível para saque em um determinado prazo (respeitando a compensação do cartão de crédito do cliente).
Transferindo o saldo do cashback da conta mestre para a subconta
Para explicar como realizar esse processo é importante explicar dois conceitos, transferência de valores e pedido saque.
Transferência de valores: Usado quando necessário transferir valores de uma conta iugu para outra conta iugu, é importante informar que essa transferência é gratuita.
Pedido de Saque: Ocorre quando existe a necessidade de transferir o dinheiro de uma conta iugu, para qualquer outra conta bancária, onde existe uma taxa para realizar esse processo.
Após realizar a cobrança com o saldo da conta mestre, deve ser realizado uma transferência para a subconta do cliente com o valor que ele precisa receber de cashback, utilizando a api Transferência de 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=0e63b5904520834294f11ab694670c5cd6f70b8a-1629116600' \
--data-raw '{
"custom_variables": [
{
"name": "deposito teste",
"value": "R$ 1.00"
}
],
"receiver_id": "18B68549A1524D03A652FBC88F25B3E2",
"amount_cents": 100
}'
Modelo de response

Com o valor de cashback disponível na subconta, deve ser realizado o saque desse valor, ou seja, a transferência do valor para a conta configurada na subconta, através da api Pedido de Saque.
Modelo de request
curl --location --request POST 'https://api.iugu.com/v1/accounts/id/request_withdraw'
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{api_token in base64}}' \
--header 'Cookie: __cfruid=0e63b5904520834294f11ab694670c5cd6f70b8a-1629116600' \
--data-raw '{
"amount": 500
}'
Modelo de response

Uma vez que ocorrer a liquidação da transação realizada pelo cliente será splitado e disponibilizado o saldo do cashback na subconta do cliente, essa ação irá disparar um gatilho da plataforma iugu chamado invoiced.realeased, após receber ele deve ser realizado a transferência da subconta para conta mestre compensando o saque realizado em primeira instancia. Veja mais sobre gatilhos aqui.
Boleto bancário
Uma vez que recebemos o arquivo de retorno do banco o saldo cobrado no boleto fica disponível para realizar o saque, isso geralmente demora 1 dia útil, porém pode ocorrer em até 3 dias uteis.
Depois disso é só realizar a chamada de saque como citado acima.
Pix
É disponibilizado de maneira instantânea na conta iugu, ou seja, quando a compra é dada como "aprovada", esses valores serão disponíveis na conta iugu, podendo ser sacados.
Depois disso é só realizar a chamada de saque como citado acima.
Updated over 1 year ago