FAQs
General
- Always make sure you are using the latest version of the Recharge JS SDK
- Always make sure you are sending your storefront token as part of the
initRecharge/init
call - Make sure that you’ve added the correct Shopify store URL as a
storeIdentifier
in theinitRecharge/init
function (somestore.myshopify.com), additional documentation - The Maris GitHub Repository that has example code is really old, is there a newer version out?
- Coming soon! Recharge is working on a newer version of the portal that we will be releasing. Will be publicly posted when we make that update.
Auth/Permissions Related
- I am getting an error related to not having sufficient permissions (scopes) or redacted data
- Is there a customerId on the returned session?
- If not your customer is not logged in or is not in recharge
- Check your storefront API token scopes
- Is there a customerId on the returned session?
- I’m getting redacted customer information from the storefront API
- Make sure the ‘Redact customer data in responses’ checkbox is unchecked for your storefront API token
- My request from
example.domain.com
isn’t working, why is it running into CORS issues?- By default only the following are whitelisted domains:
- .myshopify.com url
- Store domain
- cdn.shopify.com
- localhost
- 127.0.0.1
- Please make sure you’ve added any other domains or origin IP addresses to this list
- By default only the following are whitelisted domains:
Bundles
- We use dynamic bundles and we have 4 different weeks that allow customers to select different items from each week. Now the issue is, our items change each week for the next month and we want an option that allows the user to update their current subscription items. Is it possible to edit any existing subscription using SDK API/method so that existing subscription will continue to work with new updated items and price updates too?
- First step: determine which bundle selection is associated with certain subscription id. Use listBundleSelections endpoint with purchase_item_ids? Query param.
- Second step: Use updateBundleSelection in order to change the
bundle_selection.items
.
Customers
-
How do I use Cancellation Prevention in a custom customer portal?
- You can add a link to the action button when customers want to cancel that directs them to the Active Churn landing page. See getActiveChurnLandingPageURL
-
How do I use Failed Payment Recovery in a custom customer portal?
- If a customer has a charge error due to a payment issue, you can direct them to the Failed Payment Recovery landing page. Use the getFailedPaymentMethodRecoveryLandingPageURL
Subscriptions
- I am using updateSubscriptionChargeDate endpoint in order to reschedule the charge date. There are more than a few subscriptions included in the single charge. However at some point, I am getting 409 errors. Is there a better approach?
- Updating all subscriptions in one call using the bulk route is always better. See updateSubscriptions
- I am attempting to change subscription frequencies using the SDK using updateSubscription. However I am getting a
Not allowed to update the frequencies.
error.- We honor the customer portal settings from the merchant-admin. To change frequencies via SDK,
Customer can choose any frequency
should be checked.
- We honor the customer portal settings from the merchant-admin. To change frequencies via SDK,