Add or remove cashback from a customer

This endpoint allows you to add or remove cashback to/from a customer balance. Internally it will convert the value into points and debit it from customer,..

Some important remarks

• Use OperationType=0 if you want to add cashback. Use OperationType=1 if you want to remove cashback
• If you want to add cashback, use a positive number (eg: 10).
• If you want to remove cashback, use a negative number (eg: -10)

The ChangeKey field

This field allows you to create idempotency: even if you make the exactly same request twice it will change cashback only once. As distributed systems should be fault-tolerant it may result in requests being done more than one time. Not using the ChangeKey may duplicate a change-cashback request thus adding or removing more cashback than intended

How to use this field

Inform some string that is unique for this change. For instance: if you are adding R$10 for customerID=ABC regarding the OrderId=123 purchase he just made, our key could be ADD-ABC-10-123 If you dont need this kind of verification you can just use some time-related string, such as 2023-01-01 23:59:00:000

The Reason field

This field is important to track why some cashback are given/taken from the customer. This information is internal-use only, it will not be visible to the customer.