Rewards
Last updated
Was this helpful?
Last updated
Was this helpful?
Scope: visitor and above
This endpoint retrieves information about reward programs in the Apparel21.
The endpoint returns a list of object that includes information such as reward program id, name, tiers, and gifts.
An alias name that represents a particular brand that is using the API
Scope: visitor and above
This endpoint retrieves information about a single reward account in the Apparel21 system by accepting a required reward account id parameter.
The endpoint returns an object that includes information such as the associated program id, tier, rewards list, gift list and etc.
The Apparel21 reward account id
An alias name that represents a particular brand that is using the API
Scope: visitor and above
This endpoint retrieves transaction history of a single reward account in Apparel21.
The endpoint returns an object that includes information such as the associated program id, tier, rewards list, gift list and etc.
The Apparel21 reward account id
(Optional) Earliest date to retrieve transaction from yyyy-MM-dd format
An alias name that represents a particular brand that is using the API
Scope: maintainer and above
This endpoint confirms an unconfirmed request and commit the pending redemption of points or rewards.
This endpoint must accept a request id which is obtained from redeem reward or gift endpoint.
The endpoint returns 201 code if successful.
Request id obtained from redeem reward or gift endpoint
An alias name that represents a particular brand that is using the API
No content
Scope: maintainer and above
This endpoint reverses an unconfirmed request. This can only be done within 24 hours of a redemption request
This endpoint must accept a request id which is obtained from redeem reward or redeem gift endpoint.
The endpoint returns 201 code if successful.
Request id obtained from redeem reward or gift endpoint
An alias name that represents a particular brand that is using the API
No content
Scope: maintainer and above
This endpoint updates a person's tier information.
The endpoint returns an object that includes information such as the reward account id, program id, program name, tier details that the person is associated with.
The Apparel21 Reward account ID
An alias name that represents a particular brand that is using the API
2731522019-09-01Scope: maintainer and above
This endpoint adds a person to a rewards program.
This creates a reward account for the person and marks the new account as active'
The endpoint returns an object that includes information such as the reward account id, program id, program name, tier details that the person is associated with.
An alias name that represents a particular brand that is using the API
1273152Scope: maintainer and above
This endpoint creates a reward for a reward account.
This endpoint must accept personId, description, and amount in the request body. The rest are optional.
The endpoint returns 201 status code if request is successful.
The Apparel21 Reward account ID
An alias name that represents a particular brand that is using the API
73152DotApparel Rewards TEST502023-12-3017666SM1No content
Scope: maintainer and above
This endpoint creates a gift for a reward account.
This endpoint must accept personId, description, and gift id in the request body. The rest are optional.
The endpoint returns 201 status code if request is successful.
The Apparel21 Reward account ID
An alias name that represents a particular brand that is using the API
731522620Test gift2023-12-3017666AUG123No content
Scope: maintainer and above
This endpoint adds points to a person's reward account.
This endpoint must accept personId, points, and description id in the request body. The rest are optional.
The endpoint returns 201 status code if request is successful.
The Apparel21 Reward account ID
An alias name that represents a particular brand that is using the API
73152100Test gift2023-12-30AUG123No content
Scope: maintainer and above
This endpoint redeems a reward from a person's reward account.
This endpoint must accept personId, description, spend amount, amount, reference and auto confirm as part of the request body.
The endpoint returns a request id that can be used on confirm or reversed unconfirmed request endpoint.
The Apparel21 Reward account ID
An alias name that represents a particular brand that is using the API
73152Redeem reward5030RED123trueScope: maintainer and above
This endpoint redeems a reward from a person's reward account.
This endpoint must accept personId, description, spend amount, amount, reference and auto confirm as part of the request body.
The endpoint returns a request id that can be used on confirm or reversed unconfirmed request endpoint.
The Apparel21 Reward account ID
An alias name that represents a particular brand that is using the API
73152Redeem reward26821RED123true