free_shipping_voucher
reward, which will apply
free shipping to the cart. If the redemption is successful, the new claimed
reward and a unique voucher (coupon) code will be included in the response.
You can show the voucher code to the customer and instruct them to apply it to
their cart later. Or, if supported by your ecommerce platform, you can apply the
voucher code to the cart directly, which provides a superior user experience.
Note that free shipping vouchers may have a max shipping amount, which will be
in in claimed_reward.redeemable.max_shipping
. If present, this should be
communicated to the customer to avoid confusion.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
Response
201
The unique voucher code that will apply free shipping
"LL-XYA3816"
The new claimed reward. The voucher code can be found in claimed_reward.redeemable.code
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