error.code
of no_active_subscriptions
Choosing a variant
The reward may have been configured with multiple eligible product variants. If this is the case, you’ll need to let the customer choose which variant they want to redeem, and then pass that ID asvariant_id
when performing the redemption.
Choosing a subscription address
By default, the product will be included with the customer’s next upcoming subscription order. Alternatively, you can ask the customer to select which address they want the free product to be sent to. You can use the ReCharge API to fetch a list of the customer’s active addresses and ask them to choose which one the free product should be sent to.Authorizations
An API key linked to a Program in LoyaltyLion, with a set of permissions (scopes). API keys can be created manually, or acquired through an OAuth2 flow. The API key should be provided as a Bearer
token in the Authorization
header
Path Parameters
Your LoyaltyLion Site ID
Query Parameters
The sales channel from which this request is made. Must be provided as this query parameter, or the X-LoyaltyLion-Channel
header
web
, pos
, mobile
Body
Body
The LoyaltyLion ID of the reward to redeem
The product variant ID to redeem. If the product reward includes multiple variants, you should ask the customer which one they want to redeem
If you are using ReCharge for subscriptions, you can optionally pass a shipping address ID which will be used as the shipping address for the free product. You can fetch shipping addresses using the ReCharge API. If not provided, the free product will included with the customer's next recurring subscription order
Response
201
The new claimed reward. Details about the product can be found in claimed_reward.redeemable.product
, and details about the subscription can be found in claimed_reward.redeemable.subscription_details
The customer object, updated as of the reward redemption, i.e. their claimed_rewards
will include the new redemption. This customer will always have state
set to enrolled
, as only enrolled customers can redeem rewards