Criar cashback

📘

O que você irá aprender com esse artigo?

  • O que é cashback;
  • Caso de uso com diagrama de sequência;
  • Como criar fatura com cashback na iugu;
  • Como usar o cashback.

O que é cashback

Cashback significa dinheiro de volta, em inglês. Algumas empresas aderem esse tipo de recompensa para atrair e fidelizar seus clientes. Assim, o cliente realiza uma compra e a empresa fornecedora oferece uma recompensa que pode ser em dinheiro ou crédito para a reutilização na compra seguinte.

Caso de uso

Você tem marketplace e quer fazer uma ação de vendas ao qual o consumidor comprando seus produtos ou contratando serviços, será compensado com 10% de cashback.

Diagrama de sequência

Como criar fatura com cashback na iugu

Para trabalhar com cashback na iugu é necessário criar uma subconta para esse cliente e realizar uma configuração de split com a porcentagem ou valor definido, que representa o cashback.

Criar e configurar subconta

Para saber como realizar o processo de criação, configuração e verificação de uma subconta, acesse esse artigo aqui.

Criar a fatura

A definição do split na subconta, que representa o cashback, pode ser feita na configuração da subconta se for um valor padrão. Ou seja, se os produtos sempre retornam 5% de cashback para o comprador, basta informar 95% no split para a conta mestre. Ao criar a fatura utilizando a subconta o valor será distribuído conforme o que foi informado na subconta.

Outra possibilidade seria informar o split diretamente na fatura, para os casos em que cada produto retorna um valor ou porcentagem de cashback diferente. Nesse cenário, basta informar qual o id da subconta e o valor da porcentagem, ou valor de split que o cashback vai retornar.

Cashback com split por fatura

Faça a criação da fatura realizando um POST na API de Criar Fatura, informando o id da subconta que receberá o cashback e qual o valor dele. Nesse caso aqui o cashback será de 10%. Para saber como acessar o id da conta clique aqui.

Modelo de request

curl --location --request POST 'https://api.iugu.com/v1/invoices' \ 
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{api_token in base64}}' \
--header 'Cookie: __cfruid=1b73fa0fcd5aaa5d72e58dee93da89e98d88de4a-1635344492' \ 
--data-raw '{ 
    "email": "[email protected]", 
    "due_date": "2021-10-28", 
    "items": [ 
        { 
            "description": "Item teste c/ cashback", 
            "quantity": 1, 
            "price_cents": 12000 
        } 
    ], 
    "customer_id": "B74B1779689E4684B02BD8D2867656F6", 
    "payable_with": [ 
        "credit_card" 
    ], 
    "splits": [ 
        { 
            "recipient_account_id": "{{account_id}}", 
            "percent": 10 
        } 
    ] 
}'

*Modelo de response

No caso de um pagamento por PIX, o valor estará disponível instantaneamente na conta mestre e na subconta. Porém, se for boleto pode demorar até 2 dias úteis para compensar.

No caso de cartão de crédito, a liquidação (quando o valor fica disponível para saque) ocorre após 30 dias e se for um pagamento parcelado, então cada parcela terá uma data de liquidação. Nesse cenário, o valor que foi informado no split para a subconta só estará disponível o valor total no final da liquidação de todo o pagamento, em cada parcela liquidada será retirada uma porcentagem referente ao valor do cashback. Exemplo: O cashback é de R$10,00 e a compra foi de R$ 100 e parcelada em 12x. Cada parcela é de R$8,33 e desse valor será descontado 0,83 referente ao cashback que será repassado para o cliente.

Como usar o cashback

Depois que ocorre a liquidação do pagamento, então o valor estará disponível na subconta para ser tratado no cashback. Existe duas formas para o tratamento de cashback: Dinheiro de volta ou crédito para reutilização em nova compra ou contratação de serviço.

No primeiro caso de devolver o dinheiro(Dinheiro de volta), o valor pode ser resgatado diretamente para a conta corrente do banco à escolha do usuário, o qual pode ter uma trava de valor mínimo para resgate do saldo.

🚧

Atenção!

O saque é realizado em D+1, ou seja, no dia útil seguinte da solicitação. Por padrão 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.

No segundo cenário, o saldo disponível funciona como um crédito, que pode ser aplicada em situações específicas de acordo com seu modelo de negócio
Exemplos: Pagamento de uma próxima fatura, desconto em um boletoCriar desconto, entre outros.