iOS Buy SDK
The iOS Buy SDK makes it easy to create custom storefronts in your mobile app, where customers can buy products using Apple Pay or a credit card. The SDK connects to the Shopify platform using GraphQL, and supports a wide range of native storefront experiences.
Only direct onsite gateways are supported with the Mobile Buy SDKs.
Anchor to RequirementsRequirements
Before you can use the iOS Buy SDK, you'll need the following:
- iOS 10.0 or higher
- Xcode 8.0 or higher
- An Apple developer account
Anchor to Step 1: Generate an access tokenStep 1: Generate an access token
To generate an access token, you can generate one in the Shopify admin. Alternatively, you can create a custom app and use authorization code grant.
Anchor to Step 2: Make your products and collections availableStep 2: Make your products and collections available
After you've generated an access token, you need to make products and collections available to your custom app to access them from your app. After the products and collections are available, you can retrieve them using their respective IDs.
If you have many products or collections, then you can use bulk actions to make them available in one step.
Anchor to Make a product availableMake a product available
- From your Shopify admin, go to Products.
- From the Products page, click the product you want to make available.
- Next to SALES CHANNELS AND APPS click Manage.
- In the Sales channels and apps dialog box, select the box next to the name of your custom app.
Anchor to Make a collection availableMake a collection available
- From your Shopify admin, go to Products and click Collections.
- From the Collections page, click the collection you want to make available.
- Next to SALES CHANNELS AND APPS click Manage.
- In the Sales channels and apps dialog box, select the box next to the name of your custom app.
Anchor to Step 3: Configure your appStep 3: Configure your app
You can configure your mobile app to use Apple Pay and universal links.
If you're interested in enabling native Apple Pay refer to create Apple payment processing certificates.
Anchor to Set up universal linksSet up universal links
You can set up universal links to integrate your app with Safari. When an iOS user taps a link to your website, they'll be redirected to your app if they have it installed.
The Apple app site association file is hosted automatically on your Online Store at /.well-known/apple-app-site-association
.
- From your Shopify admin, go to Apps.
-
Click Develop apps.
-
Click the name of your app.
-
Click API Integrations.
-
In the Storefront API integration section, click Configure.
-
Expand the iOS Buy SDK configuration section.
-
Enter your Apple App ID.
-
Select Use iOS universal links.
Anchor to Step 4: Access the iOS Buy SDKStep 4: Access the i OS Buy SDK
The Mobile Buy SDK includes the iOS Buy SDK and sample apps that show how you can use the SDK.
View the iOS Buy SDK docs (version 3) on GitHubIf your app uses version 2 of this SDK or lower, then refer to this API reference instead.
Anchor to Checkout on mobileCheckout on mobile
You can use Shopify’s web checkout for your mobile app.
Using Shopify’s web checkout makes sure that your customers always have access to the latest version of the checkout, which is optimized for speed, conversion, and customer experience.
Anchor to Where to get helpWhere to get help
Mobile app development falls outside the scope of our support service. This means that Shopify support can't help if you run into problems, unless they're specifically related to the iOS Buy SDK itself. Below are the ways you can get help with the iOS Buy SDK.
Find a Shopify Partner for hire in our ecosystem of talented development agencies.
Visit the developer forums to connect with the community and learn more about the Shopify API and app development.
Open an issue in the GitHub repository.