End Points

Here is the Skeleton of APIs Xoxoday requires communicating with your point system.

Xoxoday can support varying API designs with few restrictions.

• Should be REST APIs.

• Content-type should be JSON.

• Should be HTTPS

Use the above 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

{
"unique_id":"DB123",
"auth_token":"0fe121f67cb0b90ef39fd83380bf1e12310912c86f4d7d5bfed3f3198e531b4f8d8af179b68361da28d0bc0353ce45ac7c374aa9c51dfb54c6705571f5ab8fe8"
}

Response

GetProfileAPI

The GetProfileAPI is used to verify account information and prevent fraud at the time of checkout. This API provides a second layer of account verification before the reward is sent, ensuring a seamless and secure customer experience. The API has to be built by the client so Xoxoday can consume it.

Request

{
    "api_key": "5c720ad8bae86480c01abc0b3734dcfc9sndbjasbdjhabsjdbae",
    "employee_id": "22816281"
}

Response

“*” indicates the parameter is mandatory.

Parameters

Request

Body Parameters

Property	Description
api_key	api_key you’ll share with Xoxoday in https://help.xoxoday.com/plum/developer-resources/storefront-integration/api-endpoints/sso-redirection#sso-token-from-company-session
employee_id	Employee ID or the UID of the end user

Response

Update Redemption Transaction

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

Request

{ 
"unique_id":"TTEO32S99ERCL",
"auth_token":"0fe121f67cb0b90ef39fd83380bf1e12310912c86f4d7d5bfed3f3198e531b4f8d8af179b68361da28d0bc0353ce45ac7c374aa9c51dfb54c6705571f5ab8fe8",
"total_points_redeemed":"129",
"total_points_added":null,
"order_id": "AB1890082790",
"comments": ""
}

Response

Refund API

Request

{

"unique_id" : "TTE032S99ERCL",

"auth_token" : "0fe121f67cb0b90ef39fd83380bf1e12310912c86f4d7d5bfed3f3198e531b4f8d8af179b68361da28d0bc0353ce45ac7c374aa9c51dfb54c6705571f5ab8fe8",

"transactionid" : "AB1890082790",

"redemption_amount" : "200",

"comments" : "", }

Response

Parameters

Request

Body Parameters

Parameters	Type	Description
unique_id*		Unique identifier of a user
auth_token*		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.
total_points_redeemed*
total_points_added*

Key name can be different, there’s no restriction.

Second Tab