📘

O que você irá aprender com esse artigo?

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

Caso de uso

Criei um produto com cashback e quero retornar o cashback como desconto na próxima compra.

Diagrama de sequência

O que é cashback como desconto

O cashback, que é dinheiro de volta, pode ser usado como um desconto na próxima compra do cliente. Para saber mais sobre o que é cashback acesse aqui.

Isso significa que, se utilizar o cashback como desconto ao invés de enviar para a conta bancária do cliente um valor definido ou porcentagem do que ele comprou anteriormente, ele pode utilizar esse dinheiro como um desconto na compra seguinte. Assim não é necessário realizar nenhuma ação de saque de valor.

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 que 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