--- title: Integrating with Hosted PerksWallet slug: integrating-with-hosted-perkswallet icon: 🪜 docTags: createdAt: 2026-01-06T00:41:25.328Z --- :::hint{type="info"} **Who is this for:** Partners who want to offer a Save for Later experience with zero integration effort by redirecting users to MomentScience's hosted wallet. **Outcome:** Enable Hosted PerksWallet so users see a Save for Later CTA on offer units and are redirected to perkswallet.com to save and retrieve offers. ::: # Overview With Hosted PerksWallet, MomentScience manages everything. Users see a **Save for Later** CTA on your offer unit. When they tap it, they're redirected to [perkswallet.com](https://perkswallet.com) where they enter their email or phone number to save the offer. Users can return to perkswallet.com anytime to access their saved offers. You still earn revenue share on every conversion, no integration required. :::hint{type="info"} **Need more control?** If you want to embed the wallet directly in your app or website with custom user identifiers, see [Integrating with Embedded PerksWallet](docId\:IvoLE8T7OgTN6pwTGR6Y1) instead. ::: # Getting Started ## Step 1: Enable Hosted PerksWallet Contact your MomentScience account manager to enable Hosted PerksWallet for your account. ## Step 2: Choose Your Integration Method Hosted PerksWallet supports three integration approaches. Choose the one that fits your needs: ### Option A: JavaScript SDK **Best for:** Zero-code implementation with automatic Save for Later buttons The SDK automatically renders Save for Later CTAs on your offer units. No additional code required. **How it works:** 1. The SDK renders a **Save for Later** CTA button on your offer units 2. When users click the button, they're redirected to perkswallet.com 3. Users enter their email or phone to save the offer 4. No additional code needed :::hint{type="warning"} If you haven't integrated yet, see: - [JS SDK (for Websites)](docId:-kRJZTX8LW1SoG_HYH2px) - [Perkswall](docId\:VznkLiNZojEyBoD7_vAVv) ::: ### Option B: Direct Links with URL Parameter **Best for:** Email campaigns, push notifications, and direct deep links Append `&save_for_later=1` to any Click URL to redirect users directly to the save page instead of the offer landing page. **How it works:** Take any Click URL from your offer response and add `&save_for_later=1` at the end: ```text https://trk.pubtailer.com/sdk/offer-click?o_id=5597&c_id=2901&p_id=3507&save_for_later=1 ``` When users click this modified URL: - They're redirected to `https://app.perkswallet.com/save-offer` instead of the offer landing page - They can enter their email or phone to save the offer - The offer is saved to their wallet at [perkswallet.com](https://perkswallet.com) **Setup:** - Simply modify your Click URLs by adding the parameter - Works with Direct Links and Email Tracking Links :::hint{type="info"} If the offer doesn't support PerksWallet, the `&save_for_later=1` parameter is ignored and users go to the offer landing page as usual. ::: ### Option C: Native API Call **Best for:** Custom UI with programmatic control Use the `save_for_later_url` from API responses to trigger saves when users click your custom buttons. This approach works with both the Perkswall API and MomentPerks API. **How it works:** 1. Retrieve offers from the Perkswall API or Moments API 2. Extract the `save_for_later_url` from each offer object in the response 3. When a user clicks your Save for Later button, make a POST request to the `save_for_later_url` 4. The user is redirected to `https://app.perkswallet.com/save-offer` **Example API response:** ```json { "offers": [ { "id": "12345", "title": "20% off athletic wear", "click_url": "https://trk.pubtailer.com/sdk/offer-click?o_id=5597...", "save_for_later_url": "https://api.adspostx.com/save-offer?token=abc123...", } ] } ``` **Making the save request:** ```javascript // When user clicks your custom "Save for Later" button const saveOffer = async (saveUrl) => { const response = await fetch(saveUrl, { method: 'POST', headers: { 'Content-Type': 'application/json' } }); if (response.ok) { // Redirect user to PerksWallet save page window.location.href = response.url; } }; ``` **Setup:** - Requires integration with Perkswall API or MomentPerks API :::hint{type="info"} For complete API integration details, refer to the [Perkswall API](docId:2un6uWR7-uyB7cTVyHYy_) or [MomentPerks API](docId\:zpOL4DX0Bohl2AOoyZrLQ). ::: *** ## Step 3: Customize CTA Text (Optional) Once enabled, your offers display a **Save for Later** CTA by default. You can customize the PerksWallet button text from your dashboard theme customizer. **Customizing the button text:** 1. Navigate to your chosen theme customizer page: 1. If you're using Perkswall to display offers Go to: [Perkswall Theme Customize](https://app.momentscience.com/account/integration/perkswall) 2. If you're using MomentPerks to display offers Go to: [MomentPerks Theme Customize](https://app.momentscience.com/account/integration/customize#customize) 2. Click on "**Theme Settings"** tab. 3. Make sure the **PerksWallet CTA** toggle is enabled 4. Update the button text (e.g., change "Save for Later" to "Save to Wallet") 5. Save your configuration: - Click **Save** to apply changes to the current theme - Click **Save As** to create a new theme with these changes :::hint{type="info"} If you have multiple themes, you can customize the PerksWallet CTA text independently for each one. This allows different button text across different themes. ::: :::Iframe{iframeHeight="0" code="
"} ::: *** ## User Journey ::::VerticalSplit{layout="middle"} :::VerticalSplitItem 1. User discovers an offer on your site with a **Save for Later** button 2. User taps **Save for Later** and is redirected to [perkswallet.com](https://perkswallet.com) 3. User enters their email or phone number to create a wallet account 4. The offer saves automatically and an account is created instantly 5. User returns to [perkswallet.com ](https://perkswallet.com)anytime to view, manage, and claim saved offers 6. Users receive reminder emails about saved offers to boost engagement and conversions. ::: :::VerticalSplitItem ![](https://api.archbee.com/api/optimize/ELjiwjWcrv0a1IejQFFAF/fxDy4tUcfiWSn2X6HB_9h_image.png "MomentPerks: Example for Save for Later Button") ![](https://api.archbee.com/api/optimize/ELjiwjWcrv0a1IejQFFAF/hm1pEAsCU_3fLiO4N_eWM_image.png "Perkswall: Example Save for Later Button") ::: :::: :::Iframe{iframeHeight="0" code="
"} ::: ### Cross-Device Sync When users verify their email or phone number, MomentScience links their wallet across all devices. They can: - Save an offer on mobile and claim it later on desktop - Access their wallet from any device with the same email or phone number - Pick up where they left off without losing saved offers :::hint{type="info"} Users can save offers without verifying their email or phone number, but verification enables cross-device access. ::: | **Scenario** | **Behavior** | | ----------------- | ---------------------------------------------------------- | | **Same device** | User is automatically logged in | | **New device** | User verifies email or phone number to access saved offers | | **Expired offer** | Offer is removed from wallet (only active offers shown) | *** :::hint{type="success"} **Ready to get started?** Contact your account manager to enable PerksWallet for your account. ::: *** ## Need Help? 📢 If you're running into any issues, contact us at [help@momentscience.com](mailto\:help@momentscience.com)