--- title: Shop Pay Wallet Shop Configuration Guide description: >- This guide details the setup required for a new merchant or partner onboarding for use of Shop Pay Wallet. api_name: commerce-components source_url: html: 'https://shopify.dev/docs/api/commerce-components/pay/shop-configuration' md: 'https://shopify.dev/docs/api/commerce-components/pay/shop-configuration.md' --- # Shop Pay Wallet Shop Configuration Guide *** ## Overview 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. *** ## Getting 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. *** ## Shopify Admin ### Settings 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:** 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](#brand). * 🟡 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](#apps) used to communicate with Shopify. * 🟢 Domains: Allow-list the domains where the Shop Pay Wallet JavaScript SDK is loaded. Visible once your shop has been enabled for the configuration API. * 🟡 [Notifications](#notifications): Configure customer notifications. * 🟢 Customer privacy: Configure customer privacy and consent policies. #### Payments 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](https://help.shopify.com/en/manual/payments/shopify-payments/setting-up-shopify-payments) to complete the setup. Credit card rates vary by plan, and may require manual configuration by Shopify. Contact [Shopify Support](https://help.shopify.com) with any questions about the rates listed in your shop(s). **Note:** 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](https://shopify.dev/docs/api/commerce-components/pay/javascript-sdk#configure-parameters) for details. #### Apps 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: **Legacy custom apps deprecated:** As of January 1, 2026, you can no longer create new legacy custom apps. New custom apps are built in the [Dev Dashboard](https://shopify.dev/docs/apps/build/dev-dashboard) and use OAuth to install, so the steps below are being updated. See [Get API access tokens](https://shopify.dev/docs/apps/build/dev-dashboard/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](https://shopify.dev/docs/api/usage/access-scopes). For clarity, while most public apps from the [Shopify App Store](https://apps.shopify.com/), 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. #### Brand 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**. #### Notifications **Note:** 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. ### The 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. * Add all domains where the JavaScript SDK will be loaded from. * 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. ### If the Shop sales channel is missing The Shop sales channel might have been uninstalled. Reinstall the Shop sales channel from the [Shopify App Store](https://apps.shopify.com/shop) to restore access. Your existing storefront button continues to load, and previous settings will be preserved after reinstall. *** ## Additional Resources [Shop Pay Wallet API\ \ ](https://shopify.dev/docs/api/commerce-components/pay) [API documentation for Shop Pay Wallet.](https://shopify.dev/docs/api/commerce-components/pay) [Development Journey and Key Considerations\ \ ](https://shopify.dev/docs/api/commerce-components/pay/development-journey) [A guide to assist with the development journey and key considerations for Shop Pay Wallet.](https://shopify.dev/docs/api/commerce-components/pay/development-journey) [UX Guidelines\ \ ](https://shopify.dev/docs/api/commerce-components/pay/design-guidelines) [UX documentation for Shop Pay Wallet.](https://shopify.dev/docs/api/commerce-components/pay/design-guidelines) [Troubleshooting Guide\ \ ](https://shopify.dev/docs/api/commerce-components/pay/troubleshooting-guide) [A guide to assist with troubleshooting Shop Pay Wallet implementations.](https://shopify.dev/docs/api/commerce-components/pay/troubleshooting-guide) [Test Shop Pay\ \ ](https://shopify.dev/docs/api/commerce-components/pay/test-shop-pay) [A guide to testing Shop Pay Wallet with test credit cards.](https://shopify.dev/docs/api/commerce-components/pay/test-shop-pay) [Shop Pay Installments activation\ \ ](https://help.shopify.com/en/manual/payments/shop-pay-installments/activating-shop-pay-installments) [A guide to activating Shop Pay Installments.](https://help.shopify.com/en/manual/payments/shop-pay-installments/activating-shop-pay-installments) ***