📘

O que você irá aprender com esse artigo?

• O que é cashback
• Como criar fatura com cashback
• Como usar o cashback
• Prazos

O que é cashback?

Cashback é um termo em inglês que se traduz como "dinheiro de volta". Trata-se de um benefício oferecido por alguns vendedores que permite ao cliente receber de volta uma parte do dinheiro gasto em compras. Esse retorno pode se dar de duas formas: diretamente como dinheiro, que pode ser depositado na conta bancária do cliente, ou como crédito, que pode ser usado em compras futuras na mesma loja ou plataforma. Essa prática incentiva os clientes a continuarem comprando enquanto economizam.

Caso de uso

"Em um marketplace que deseja impulsionar vendas através de uma promoção, uma estratégia eficaz é oferecer cashback aos consumidores. Neste cenário, ao adquirir produtos ou serviços, o consumidor recebe uma compensação de 10% do valor gasto de volta. Esta abordagem não só incentiva compras repetidas, mas também aumenta a satisfação e fidelidade do cliente."

Que tal uma Recipe? 🧪

Veja, na prática, como e quais endpoints utilizar com a recipe abaixo:

Subconta dedicada

Para implementar cashback, é essencial criar uma subconta dedicada para o cliente e configurar um split de pagamento. Esta configuração deve especificar a porcentagem ou o valor exato que será retornado como cashback.

Criar, configurar e verificar Subconta

Para criar faturas com cashback, antes, deve-se criar, configurar e verificar a subconta dedicada a este cliente. Saiba mais. Aqui estão os endpoints:

• Criar subconta — v1/marketplace/create_account
• Configurar conta — v1/accounts/configuration
  • Utilize o array of objects splits para configurar o valor do cashback. Esta configuração representará uma configuração padrão para todas as faturas. Caso queira aplicar cashbacks variáveis, utilize o Split por Fatura.
• Enviar verificação de subconta — v1/accounts/{account_id}/request_verification

Após realizar estas etapas, continue com este artigo.

Criar a fatura

Existem duas formas de splitar o valor do cashback:

1. Configuração Padrão: Será o mesmo valor (cashback) para todas as Faturas.
2. Split por Fatura: Permite variar o valor, por fatura, com o array of objects splits (apenas API).

❗️

Não realize split de 100% da Fatura

A soma dos splits devem totalizar um valor deduzindo as tarifas da iugu. Por exemplo:

• Fatura de R$10,00
• Divisão entre 2 contas
• Tarifa da iugu = R$ 1,00

Então, a divisão dos valores devem totalizar R$9,00.

Padrão

1. Configure a Conta. No endpoint Configurar conta — v1/accounts/configuration, utilize o array of objects splits. Nos parâmetros:

• recipient_account_id: Insira o ID da Conta que receberá o valor do cashback
• percent: Insira o valor percentual do cashback
• cents: Insira o valor em centavos do cashback

📘

Posso usar percent + cents?

Sim. Para isso, no mesmo array splits, utilize o parâmetro permit_aggregated como true.

2. Crie uma Fatura. No endpoint Criar Fatura — v1/invoices, utilize os parâmetros obrigatórios (ou relevantes) para a requisição.

Resultado

Todas as Faturas terão seu valor splitado para a conta informada no parâmetro recipient_account_id e, a depender da sua escolha, o valor do cashback será percentual ao valor total da fatura, um valor fixo ou percentual + fixo (permit_aggregated).

Split por Fatura

O Split por Fatura sobrepõe as configurações de split realizadas no Painel (alia.iugu.com) ou pelo endpoint Configurar conta — v1/accounts/configuration.

Crie uma Fatura. No endpoint Criar Fatura — v1/invoices também há o array splits, então, siga a mesma lógica utilizada nas etapas 1 e 2 anteriores, porém, realize-as apenas neste endpoint.

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

Prazos de por método de pagamento

Os métodos de pagamento têm prazos diferentes para que o valor do cashback fique disponível. São eles:

Cartão de Crédito

Antecipação*

Se for realizada antecipação de valores para transações de cartão de cartão de crédito, o cashback poderá ocorrer antes dos 30 dias previstos.

Compras parceladas

Cada parcela há sua respectiva data de liquidação, isso significa que o valor total que foi splitado (cashback) ficará disponível após a liquidação da última parcela.

👍

Temos gatilhos para esse evento

Utilize os gatilhos Fatura Liberada — invoice.released e Parcela da Fatura Liberada — installment_released para ser notificado sempre que esses valores forem liquidados

Boleto Bancário

A liquidação do valor depende da compensação do boleto que pode ocorrer em até 2 dias úteis.

Como usar o cashback?

Após a liquidação do pagamento, o valor é disponibilizado na subconta para uso em cashback de duas maneiras:

• Reembolso direto
• Crédito para futuras compras ou serviços

Reembolso direto

O usuário pode transferir o valor para a conta corrente de sua escolha, observando um valor mínimo de resgate estipulado (R$5,00).

🚧

Importante

Os saques são processados no dia útil seguinte à solicitação, com um valor mínimo de R$ 5,00. Além disso, saques solicitados às sextas-feiras serão processados apenas na segunda-feira seguinte, excluindo finais de semana e feriados.

Crédito para compras futuras

No segundo cenário, o saldo funciona como crédito, utilizável em transações específicas conforme o modelo de negócio, como pagamento de faturas futuras, obtenção de descontos em boletos, entre outras aplicações.

Obter mais ajuda

Consulte os artigos relacionados para saber como utilizar o Cashback como desconto e como resgate.