📘

O que você irá aprender com esse artigo?

• O que é cashback como desconto;
• Como usar o cashback como desconto.

O que é cashback como desconto

O cashback como desconto, é tipo de desconto especial quando compramos algo ou contratamos algum serviço. Nesse caso seria um desconto na próxima compra ou contratação de serviço que o cliente pode estar utilizando. Para saber mais sobre o que é cashback acesse aqui.

Isso significa que, se utilizar o cashback como desconto, com o saldo que já está na conta iugu do cliente (um valor definido ou porcentagem do que ele comprou ou contratou anteriormente), não será necessário enviar para a conta bancária externa do cliente (Transferência Própria /Saque), nem ter a possibilidade de usar para pagamento de contas com código de barras. em suma utilizar esse cashbackcomo um desconto na compra seguinte, não sendo necessário realizar nenhuma ação de saque de valor para transferência.

Como usar o cashback como desconto

Validar saldo

Antes de disponibilizar o desconto para o cliente é necessário validar qual o valor que ele possui disponível na conta do cliente, pode ser usado no desconto da compra. Para isso realize um GET na API de Informações da conta passando o api_token e o id da conta (saiba aqui como acessar esses dados).

Modelo de request

curl --location --request GET 'https://api.iugu.com/v1/accounts/{{account_id}}' \ 
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic {{api_token in base64}}' \
--header 'Cookie: __cfruid=1b73fa0fcd5aaa5d72e58dee93da89e98d88de4a-1635344492'

Transferência entre contas

Após validar quanto possui de saldo na conta, faça uma transferência do valor que será definido como desconto na compra. Essa transferência é entre contas iugu, da subconta para a conta mestre. Para saber como realizar essa transferência clique aqui. Informe na requisição o valor e o id da conta mestre que será a de destino.

Criar fatura com desconto

Crie a fatura informando o valor do cashback, que será descontado do total da fatura, no campo discount_cents. Essa requisição é uma chamada do tipo POST na API de Criar fatura.

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-27", 
    "items": [ 
        { 
            "description": "Item teste", 
            "quantity": 1, 
            "price_cents": 89000 
        } 
    ], 
    "discount_cents": 1200, 
    "payable_with": [ 
        "all" 
    ], 
    "customer_id": "B74B1779689E4684B02BD8D2867656F6" 
}'

Modelo de response

Caso de uso

Se comprarmos um produto ou contratamos um serviço que custa R$ 100 e a loja oferece 10% de cashback, eles nos devolverão R$ 10. Então, ao invés de pagarmos R$ 100, pagaremos apenas R$ 90. É como se a loja estivesse nos dando um presente ou uma recompensa por comprarmos algo lá. É uma forma de economizar dinheiro e aproveitar um benefício extra ao fazer compras. Criei um produto com cashback e quero retornar o cashback como desconto na próxima compra._

Diagrama de sequência