Transaction ‐ Redeem Points (Ecom) - kangaroorewards/api-docs GitHub Wiki
Redeem points(Ecom)
In this tutorial, you will learn how to redeem the customer point balance and get the Ecom integration coupon code through the Kangaroo Rewards API. After the redemption is completed, a new transaction will be created. Currently, this functionality is only applicable to the Shopify integration.
Objective: Learn how to redeem the customer points and get back the ecom integration coupon code.
Prerequisites:
- Basic understanding of APIs and HTTP requests.
- A registered business account with Kangaroo Rewards.
- An API client like Postman or cURL installed.
- An OAuth2 App registered with Kangaroo Rewards
- A valid Access Token
- Shopify-Kangaroo Rewards integration is authorized.
Redeem the customer point balance
1. Authentication
Get an access token or refresh an existing one as explained here. With the access token, you can start making API calls.
2. Get the eCom branch id from the branches API.
curl -X GET https://api.kangaroorewards.com/branches?include=virtual_branch \
-H "Authorization: Bearer <access_token>" \
-H "X-Application-Key: <X-Application-Key>" \
-H "Accept: application/vnd.kangaroorewards.api.v1+json" \
-H "Content-Type: application/json" \
Loop through the branches in the response to find the eCom branch, which has virtual_branch_flag set to true.
3. Make a request to the transactions API endpoint using cURL
curl -X POST https://api.kangaroorewards.com/transactions \
-H "Authorization: Bearer <access_token>" \
-H "X-Application-Key: <X-Application-Key>" \
-H "Accept: application/vnd.kangaroorewards.api.v1+json" \
-H "Content-Type: application/json" \
-D '{
"intent": "redeem_ecom_coupon",
"amount": 5,
"subtotal": 30,
"branch": {
"id": "11eb82ae6d3f1ec4b847e2865c66d9cc"
},
"customer": {
"id": "11eea0e1e994d24d9fede2865c66d9cc"
}
}'
Note: Replace
<access_token>
with the actual access token.
- intent: redeem_ecom_coupon
- amount: The redemption amount. The customer’s point balance will be decreased by the eCom redemption ratio based on the integration rules.
- subtotal: The sale's subtotal amount. In the eCom integration rules, the minimum/maximum redemption allowed is based on the subtotal amount. The redemption amount should adhere to these limitations and be calculated based on the subtotal amount.
- branch.id: Branch ID is required and must be a virtual branch. The branch ID that the redemption transaction is associated with.
- customer.id: It’s required if the customer email and phone are not present.
- customer.email: It’s required if the customer id and phone are not present.
- customer.phone: It’s required if the customer id and email are not present.
Note:
- customer: At least one of id, email, phone is present in the request.
- You will find the ecom_coupon.code from the response, this is the eCom platform's coupon code.
4. Handle the response appropriately in your code.
Conclusion
By following this tutorial, redeeming customer points will be successfully completed. The corresponding redemption transaction will be created, and the points will be deducted from the customer's balance.
Additional Resources
- Official Documentation: Kangaroo Rewards API Documentation
- Community Support: Kangaroo Rewards Knowledge Base
- Branches API Reference: Branches API Reference
- Create Transaction Reference: Create Transaction API Reference
Feel free to reach out to support if you have any questions or need further assistance.