Generic Redemption APIs
Here is the skeleton of APIs, Xoxoday requires, whilst communicating with your point system.
Xoxoday can support varying API designs with few restrictions.
  1. 1.
    Should be REST APIs.
  2. 2.
    Content-type should be JSON.
  3. 3.
    Should be HTTPS
Use these API Skeletons to design your APIs.

Fetch Redemption Point Balance

Xoxoday will use this API to fetch a userโ€™s points from your point system.

Request:

Method
URL
GET/POST
https://<3rd-party-api-url-for-fetch-points>
Params
Values
unique_id*
auth_token*
Unique identifier of a user
Some authorization value to successfully allow the request from xoxoday to your system. Authorization can be but not limited to hash, Basic auth, Bearer token
* Key name can be different, thereโ€™s no restriction

Request Body:

1
{
2
"unique_id":"DB123",
3
"auth_token":"0fe121f67cb0b90ef39fd83380bf1e12310912c86f4d7d5bfed3f3198e531b4f8d8af179b68361da28d0bc0353ce45ac7c374aa9c51dfb54c6705571f5ab8fe8"
4
}
Copied!

Sample Response:

1
Status: 200 OK
2
Body:
3
{
4
"status":"1",
5
"points_info":{
6
"points_received":"2000",
7
"points_redeemed":"1300",
8
"points_available":"700"
9
}
10
}
Copied!
* This is just a sample response, it can vary according to your API design.

Update Redemption Transaction

Xoxoday will use this API to update a userโ€™s points in your point system.

Request:

Method
URL
POST/PUT/PATCH
https://<3rd-party-api-url-for-update-points>
Params
Values
unique_id*
auth_token*
total_points_redeemed*
total_points_added*
Unique identifier of a user
Some authorization value to successfully allow the request from Xoxoday to your system. Authorization can be but not limited to hash, Basic auth, Bearer token, etc.
* Key name can be different, thereโ€™s no restriction

Request Body:

1
{
2
"unique_id":"TTEO32S99ERCL",
3
"auth_token":"0fe121f67cb0b90ef39fd83380bf1e12310912c86f4d7d5bfed3f3198e531b4f8d8af179b68361da28d0bc0353ce45ac7c374aa9c51dfb54c6705571f5ab8fe8",
4
"total_points_redeemed":"129",
5
"total_points_added":null,
6
"extra": {
7
"order_id": "AB1890082790",
8
"amount": "129",
9
"products": [
10
{
11
"id": "123456",
12
"name": "product name",
13
"price": 29
14
},...
15
]
16
}
17
}
Copied!

Sample Response:

1
Status: 200 OK
2
โ€‹
3
Body:
4
โ€‹
5
{
6
"status":"1",
7
"message":"Successfully updated"
8
}
9
โ€‹
Copied!
* This is just a sample response, it can vary according to your API design.
Last modified 7mo ago