This API is used to update fulfilment status and transaction custom fields for issued rewards
Note
- For detailed information about our APIs and for hands-on testing, refer documentation in API overview and step-by-step guide on making your first API call in Make your first API call.
Prerequisites
- Authentication: Basic or OAuth authentication
- Default access group
Resource information
URI | /api_gateway/rewards/core/v1/management/transactions?skip_validation=true |
HTTP Method | PUT |
Pagination | No |
Batch support | No |
Rate limit information | None |
API endpoint example
https://eu.api.capillarytech.com/api_gateway/rewards/core/v1/management/transactions?skip_validation=true
Request path parameters
Parameter Name | Data Type | Description |
---|---|---|
skip_validation | String | A validation code is used to redeem points for the transaction. You can set skip_validation to true in the configuration to bypass the validation code for points redemption. |
Request body parameters
Parameter | Data Type | Description |
---|---|---|
| array | Details about the transaction. |
| integer | A unique ID for the transaction associated with the reward. |
| integer | A unique ID for the customer associated with the transaction. |
| integer | A unique ID for the reward associated with the transaction. |
| object | Custom transaction fields enhance the ability to track and manage reward points beyond standard fields, meeting specific needs and requirements. Supported data types are String, Integer, Date, and Boolean. The default limit for transaction custom fields is 20. Consider the following scenarios: Scenario 1: A brand partners with a third-party vendor to deliver their product, requiring additional tracking like vendor ID, handling instructions, and delivery date. To manage this, create custom fields for |
| object | The |
| string | The current status of the fulfillment process. Statuses can be created from Create fulfillment status. |
{
"transactions": [
{
"transactionId": 3482445,
"customerId": 85076836,
"rewardId": 177657,
"transactionCustomFields": {
"Partner_Order_Id" : "6565454987656",
"Date" : "10/09/2024",
"Time" : "evening",
"Seat_Section" : "Orchestra",
"Seat_Row" : "Q",
"Seat_Number" : "205",
"Paypal_Order_Id" : "45678",
"Paypal_amout" : "30$"
},
"fulfillmentDetails": {
"status": "Confirmed"
}
}
]
}
Response parameters
Parameter | Description |
---|---|
transactions | Details about the transaction. |
id | Unique id of the transaction to fetch. |
customerId | Unique id for the customer associated with the transaction. |
rewardId | Unique id for the reward associated with the transaction. |
fulfillmentDetails | Details about the fulfillment status. |
id | Unique id of the fulfillment details |
status | Current status of the fulfillment process. |
{
"transactions": [
{
"transactionId": 3482445,
"rewardId": 177657,
"customerId": 85076836,
"fulfillmentDetails": {
"id": 9,
"status": "Confirmed"
},
"transactionCustomFields": {
"Partner_Order_Id": "6565454987656",
"Date": "10/09/2024",
"Time": "evening",
"Seat_Section": "Orchestra",
"Seat_Row": "Q",
"Seat_Number": "205",
"Paypal_Order_Id": "45678",
"Paypal_amout": "30$"
}
}
]
}