📘

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.