Shop Pay Wallet Shop Configuration Guide
Anchor to OverviewOverview
This document details the configuration applicable for use of Shop Pay Wallet.
At a high level, there are a few things to keep in mind when adopting this component:
- A Shopify store is required as a conduit for certain actions, including granting API access keys, configuration and processing of payments through Shopify Payments, and interactions with Shop.
- The modifications to your existing checkout workflows are:
- Augmenting your checkout email entry with automatic email recognition.
- The customer completes an order in the Shop Pay Checkout pop-up.
- Your system validates the order before finalizing the transaction with Shopify.
- When orders are fulfilled, your system must update fulfillment information in Shopify which enables customers to track their packages in the Shop app.
Anchor to Getting Started with ShopifyGetting Started with Shopify
If you don't yet have a Shop Pay Wallet development shop, you'll be prompted to create one during sign-up.
Once you've logged into your shop, you'll see the Shopify Admin. If you're already familiar with Shopify, you'll notice that this plan has a refined UI, including only the features and settings that are relevant to Shop Pay Wallet. It's recommended to familiarize yourself and your team with the features and settings that are available to you.
Anchor to Shopify AdminShopify Admin
Anchor to SettingsSettings
Refer to the settings area of the Shopify admin to fully configure the following sections marked with 🟢.
Review the information available to you in the sections marked with 🟡.
Note: Some of these settings will require elevated permissions, so it's recommended to have the account owner for your shop available to grant permissions where needed, and to configure those sections available only to the account owner.
Note: Some of these settings will require elevated permissions, so it's recommended to have the account owner for your shop available to grant permissions where needed, and to configure those sections available only to the account owner.
Organization settings:
-
🟢 Users: Delegate permissions to staff through roles and groups, and configure security settings for your organization
-
🟢 Billing: Configure a payment method and billing profile for your organization
Store settings:
-
🟢 General: Essential configurations that will impact your use of Shopify, including the Brand assets used in the Shop Pay Checkout header.
-
🟡 Plan: Information about your Shopify plan.
-
🟢 Billing: Shop-level billing details for your store.
-
🟢 Users: Manage staff access for this shop.
-
🟢 Payments: Required configuration for Shopify Payments and payment capture settings.
-
🟢 Apps: Configure your custom app used to communicate with Shopify.
-
🟢 Domains: Verify an external storefront domain for your shop. To allow-list origins that load the Shop Pay Wallet JavaScript SDK, use the Shop sales channel.
-
🟡 Notifications: Configure customer notifications.
-
🟢 Customer privacy: Configure customer privacy and consent policies.
Anchor to PaymentsPayments
Shop Pay Wallet processes payments using Shop Pay via Shopify Payments.
You will need to onboard and configure Shopify Payments sufficiently to be enabled in test mode for your development shop(s), and for your production shop, the account owner will need to complete the onboarding process. This will require verification of information about your business to fully activate Shopify Payments and enable payouts. Follow these instructions to complete the setup.
Credit card rates vary by plan, and may require manual configuration by Shopify. Contact Shopify Support with any questions about the rates listed in your shop(s).
You're able to test your Shop Pay Wallet integration without completing the Shopify Payments configuration, as long as your Shopify Payments account is in test mode, and the Shop Pay Wallet session is initialized with the debug parameter set to true. See the configure parameters for details.
You're able to test your Shop Pay Wallet integration without completing the Shopify Payments configuration, as long as your Shopify Payments account is in test mode, and the Shop Pay Wallet session is initialized with the debug parameter set to true. See the configure parameters for details.
Anchor to AppsApps
A Custom App is an essential component of the Shop Pay Wallet configuration, acting as a conduit between Shopify and your existing platform. By default, the Shop Pay Wallet plan will have a Custom App pre-configured with the essential Storefront API permissions required for use of Shop Pay Wallet.
Depending on your system architecture, you may need to create one or more additional custom apps to support your Order Management System (OMS) or other systems. Each app should be configured with only the required scopes for the functionality you're implementing.
To create a new custom app, follow these steps:
As of January 1, 2026, you can no longer create new legacy custom apps. New custom apps are built in the Dev Dashboard and use OAuth to install, so the steps below are being updated. See Get API access tokens for the current flow for retrieving an Admin API access token.
As of January 1, 2026, you can no longer create new legacy custom apps. New custom apps are built in the Dev Dashboard and use OAuth to install, so the steps below are being updated. See Get API access tokens for the current flow for retrieving an Admin API access token.
-
Go to Settings > Apps > Develop apps > Create an app
-
Enter an app name and click Create app
-
Click Configure Admin API scopes
-
Select the scopes required by this app and click Save
-
Click Install app > Install
-
Copy the Admin API access token and store it securely
-
Configure your app to use the access token in your implementation
For details on Shopify custom app scopes, see access scopes.
For clarity, while most public apps from the Shopify App Store, have not been validated for use with Shop Pay Wallet, some apps may still function as expected. At your discretion, you may work with a Shopify app developer to validate the functionality of their app on the Shop Pay Wallet plan, for your use.
Anchor to DomainsDomains
Shop Pay Wallet uses two domain settings for different purposes. Before you add or verify a domain, make sure you're in the right place for your goal:
- Settings > Domains verifies an external storefront domain for your shop. New domains require DNS TXT verification, and each external domain can be connected to only one store. Shopify uses this verified domain for the View online store link on buyers' order receipts in the Shop app, for Affirm setup when Shop Pay Installments is enabled, and for Shopify Payments risk and audit processes. To allow-list origins that load the Shop Pay Wallet JavaScript SDK, use the Shop sales channel instead.
- Shop sales channel > Domains allow list is where you add the origins that can load the Shop Pay Wallet JavaScript SDK and Shop Pay checkout. These origins don't require verification, can be reused across stores, and must be full origins with a scheme and host, without a port. Examples include
http://localhost,https://your-tunnel.ngrok.app, andhttps://store.example.com. For Shop sales channel setup and allowed origin configuration, see The Shop sales channel.
Anchor to BrandBrand
To enable your branding to appear in the Shop Pay Checkout header, you'll need to configure it in your shop settings. Navigate to Settings > General, then click Manage in the Brand assets section, and complete the configuration.
To enable your logo and support contact information to appear in the Shop app, you'll need to upload a logo in the Brand in Shop app section of the Shopify admin. Navigate to Shop > Brand in Shop app, then click Edit details.
Anchor to NotificationsNotifications
Shopify doesn't send notifications for orders created through Shop Pay Wallet. However, based on a customer's preferences in their Shop account, customers typically expect fulfillment notifications from the Shop app, and these are dependent on your system updating fulfillment information in Shopify as fulfillment actions are performed.
Shopify doesn't send notifications for orders created through Shop Pay Wallet. However, based on a customer's preferences in their Shop account, customers typically expect fulfillment notifications from the Shop app, and these are dependent on your system updating fulfillment information in Shopify as fulfillment actions are performed.
Anchor to The Shop sales channelThe Shop sales channel
The Shop channel should be visible in the navigation of your Shopify admin.
The homepage of the Shop channel will contain information and configurations that your developers will need to enable Shop Pay Wallet in your checkout:
-
Domains allow list, which are the origins that are allowed to load the Shop Pay Wallet JavaScript SDK and Shop Pay checkout.
- Add every origin where the JavaScript SDK loads, each specified as a full origin with scheme and no port (for example,
http://localhost,https://your-tunnel.ngrok.app, orhttps://store.example.com). - These origins don't require DNS verification and are separate from the verified external storefront domain in Settings > Domains.
- Add every origin where the JavaScript SDK loads, each specified as a full origin with scheme and no port (for example,
-
Your Shopify Shop ID.
-
Your Shop Pay Client ID.
You should also edit the Shop brand settings, and populate as much as possible to avoid default contact information from being used when customers navigate to your shop in the Shop app.
Anchor to If the Shop sales channel is missingIf the Shop sales channel is missing
The Shop sales channel might have been uninstalled. Reinstall the Shop sales channel from the Shopify App Store to restore access. Your existing storefront button continues to load, and previous settings will be preserved after reinstall.
