> Portal Navigation: > > - Append `.md` to any URL under `https://dev.wix.com/docs/` to get its markdown version. > - Pages are either content pages (article or reference text) or menu pages (a list of links to child pages). > - To get a menu page, truncate any URL to a parent path and append `.md` (e.g. `https://dev.wix.com/docs/sdk.md`, `https://dev.wix.com/docs/sdk/core-modules.md`). > - Top-level index of all portals: https://dev.wix.com/docs/llms.txt > - Full concatenated docs: https://dev.wix.com/docs/llms-full.txt # Method name: redeemPointsForCoupon(rewardId: string, options: RedeemPointsForCouponOptions) # Method package: wixLoyaltyV2 # Method menu location: wixLoyaltyV2 --> coupons --> redeemPointsForCoupon # Method Link: https://dev.wix.com/docs/velo/apis/wix-loyalty-v2/coupons/redeem-points-for-coupon.md # Method Description: Redeems a customer's loyalty points for a loyalty reward and creates a loyalty coupon. Creating a loyalty coupon also creates a corresponding "reference" coupon with the [Coupons API](https://dev.wix.com/docs/rest/business-management/marketing/coupons/coupons/coupon-object.md). The customer receives the reference coupon, which they can apply to their order. The loyalty coupon and its corresponding reference coupon are linked and the loyalty coupon's `status` reflects the current state of the reference coupon. Check which loyalty rewards a site has available with List Rewards in the Loyalty Rewards API. # Method Code Examples: *** Note: do not assume any prop names or enum values other than the ones in the example. ## Redeem points for coupon ```javascript import { coupons } from "wix-loyalty.v2"; import { webMethod, Permissions } from "wix-web-module"; import { elevate } from "wix-auth"; /* Sample parameter values: * { * "rewardId": "00000000-0000-0000-0003-000000000000", * "options": { * "loyaltyAccountId": "d0dc5ba3-4a10-4cfc-b304-c976d8ac7303" * } * } */ const elevatedRedeemPointsForCoupon = elevate( coupons.redeemPointsForCoupon, ); export const redeemPointsForCoupon = webMethod( Permissions.Anyone, async (rewardId, options) => { try { const result = await elevatedRedeemPointsForCoupon(rewardId, options); return result; } catch (error) { console.error(error); // Handle the error } }, ); /* Promise resolves to: * * { * "coupon": { * "_createdDate": "2024-06-12T08:29:56.594Z", * "_updatedDate": "2024-06-12T08:29:56.594Z", * "_id": "56826083-0c4a-4e62-88e3-c6978482bde9", * "accountId": "d0dc5ba3-4a10-4cfc-b304-c976d8ac7303", * "couponReference": { * "code": "6QLGQ9RNNR9R", * "couponId": "a6df2aeb-50fc-4b15-b18d-765be38a6513", * "name": "10% off all events", * "specification": { * "type": "PERCENT_OFF_RATE", * "percentOffRate": 10, * "scope": { * "name": "ticket", * "namespace": "events" * }, * "limitedToOneItem": false * } * }, * "memberId": "7d368843-6f0c-4037-8d0e-b7e36a8a0c32", * "memberIdDeprecated": "7d368843-6f0c-4037-8d0e-b7e36a8a0c32", * "revision": "1", * "rewardName": "10% off all events", * "status": "PENDING" * } * } */ ``` ## Redeem points for coupon (dashboard page code) ```javascript import { coupons } from "wix-loyalty.v2"; /* Sample rewardId value: * * { * "rewardId": "00000000-0000-0000-0003-000000000000" * } */ async function redeemPointsForCoupon(rewardId, options) { try { const result = await coupons.redeemPointsForCoupon(rewardId, options); return result; } catch (error) { console.error(error); // Handle the error } } /* Promise resolves to: * * { * "coupon": { * "_createdDate": "2024-06-12T08:26:33.148Z", * "_id": "87c95680-55ea-4baa-936c-c4bab711fbf3", * "_updatedDate": "2024-06-12T08:26:33.148Z", * "accountId": "d0dc5ba3-4a10-4cfc-b304-c976d8ac7303", * "couponReference": { * "code": "6QLGPJTXXR58", * "couponId": "638950a0-ed55-4d47-8bc4-7145d56fe568", * "name": "10% off all events", * "specification": { * "type": "PERCENT_OFF_RATE", * "percentOffRate": 10, * "scope": { * "name": "ticket", * "namespace": "events" * }, * "limitedToOneItem": false * } * }, * "memberId": "7d368843-6f0c-4037-8d0e-b7e36a8a0c32", * "memberIdDeprecated": "7d368843-6f0c-4037-8d0e-b7e36a8a0c32", * "revision": "1", * "rewardName": "10% off all events", * "status": "PENDING" * }, * "transactionId": "2d558a56-0794-420a-81c4-49a96f1d5d9f" * } */ ``` ---