Checkify is a custom app that provides an improved checkout experience for Shopify stores. It allows merchants to accept orders using a customizable checkout web page and the Thank You page. Since Checkify is published in the Shopify App store, you need to go through several specific steps to get it running.
Q: Why don't you just list Checkify in the App Store for everyone to access and install easily?
A: According to Shopify Terms of Service, alternative checkouts cannot be launched as Public Applications:
Section 2.3, API Restrictions, demands that merchant's employees, agents and service providers will not use an alternative to Shopify Checkout for web checkout or payment processing, or register any transactions through the Shopify API in connection with such activity, without Shopify’s express written authorization. A requirement that applies to Public Applications.
A “Public Application” means an Application that accesses the Shopify API via an API Client and that is made available to Merchants either via a URL or through the Shopify App Store, and that is not a Custom Application.
Respecting Shopify rules, we work on the product as a custom app, observing all the best practices in data security, privacy, GDPR / CCPA compliance, etc.
In this article:
1. Create an account on Checkify
The first step in connecting Checkify is to register (create an account). Please note that if you have already registered on our main website during the beta-testing period (end of 2020 - beginning 2021), you still will be asked to go through the registration process (for security reasons).
The recommended browser is the latest version of Google Chrome. Our app will work with any browser, but the best experience is achieved with Chrome. For example, it enables useful extensions (pixel helpers).
NOTE: We recommend using a real and valid email which can be accessed by you, but not a personal one. Using a separate business email is beneficial in case you decide to transfer or sell your Shopify store with Checkify connected to it. Once connected, you can change both the email and the password in your profile at any time.
After the email confirmation, you will be taken to a limited version of Checkify's admin panel. Full app features will be unlocked after the successful connection of a store.
Next, add your primary Shopify store name example without ".myshopify.com" (example.myshopify.com) to the corresponding field, so we can identify your store. When you are done, click on the "Go to next step" button.
Checkout setup steps in the Checkify admin panel
ATTENTION: Repeated registrations are not allowed and are not technically possible on our product.
2. Activate "Develop apps" in Shopify and install
You can also follow the video instruction or just keep reading the detailed steps which are described in this document under the video:
1. In your Shopify admin, go to Sales channels (in the menu of the left), select App and sales channel settings > Develop apps.
Please make sure to allow custom app development.
2. Click "Create an app" button in the top part of the interface, or click on the banner:
3. Give your app a name and select an email from the dropdown. Confirm by pressing "Create app" button.
4. Continue the process in your Shopify store admin by clicking "Configure Admin API scopes" button.
5. Enable the access (permissions) for the app in Admin API access scopes:
Return to Checkify admin and view the permissions list:
You can use the table below to define the proper values for all the permissions (only highlighted permissions should be changed from the default state). You will have a shortened list on Checkify installation step screen.
List of all the permissions
There are mandatory and optional permissions for the custom app. The must-have permissions are shown in the image below.
If you intend to use import of legal terms (links) to the checkout page consider adding the permission as shown below:
With read_legal_policies enabled you may pull such documents as terms and conditions, privacy policy from the store to the checkout and the Thank You pages, boosting transparency, trust and buyer confidence.
If you need some items of the created order to be marked as 'fulfilled' automatically, add the following optional permissions:
It will minimize your effort with dealing with those elements of the imported order that do not require shipping.
Checkify asks only for the bare minimum of permissions required for ensuring smooth and proper operation of the app.
This step is VERY important, so please double-check that all the settings are correct. We have no tracking or visibility that may allow us see and pinpoint on what's not being checked (set) correctly.
ATTENTION: DO NOT change "Webhook subscriptions", "Google Cloud Pub/Sub" and "Amazon EventBridge" from the default value. DO NOT change the "Storefront API" block as well!
When you are done, click "Save" button.
6. After granting the permissions, press the "Install app" button on the "Overview" tab to get the access token unique for your new custom app.
7. Confirm your action by pressing the "Install" button again.
8. Check the window containing the three keys (credentials) crucial for running the custom app, on the "API credentials" tab.
ATTENTION: "Admin API access token" is generated and can be seen (revealed) just once. We highly recommend you to copy-paste it and store it in some secure place (like a digital vault). Or, for example, add it to some doc you use for keeping notes immediately upon seeing (revealing).
9. Reveal and paste all of the credentials (three keys) to Checkify admin in order to connect the store.
ATTENTION: double-check the names of the keys and paste the corresponding ones from the Shopify admin.
Important! If your store has password protection enabled, Checkify will not show up after publishing. Please note that direct checkout links/buttons on your landing pages/email newsletters cannot be replaced automatically. It is required to set them up manually. Learn more in the article. |
3. Next steps
You can find more information about your following steps with Checkify in our article.
4. Resolving common issues
🙀 I cannot complete the final installation step. What could be the problem?
Please ensure that
You have copied and pasted the valid app credentials from Shopify to the proper fields on Checkify.
You have granted the custom app all the required permissions.
The "Storefront API" option (block) has not been changed.
If everything mentioned above is correct, then please contact us. Attach visuals (screenshots or a video) and a detailed text description of the situation you are facing.
🙀 I have done everything correctly and double-checked it. Checkify still does not appear in my store. What else can I do?
Checkify cannot be published on stores with password protection. Make sure you remove the password before publishing and testing the checkout.
In some cases, you will need to add the script to your theme manually, as publishing of our script to your store's source code may not always happen automatically.
To do so, go to Online Store > Themes > Current theme > Actions > Edit code. Find theme.liquid file in the left menu and add this script right before closing </head> tag:
<script data-checkify-url="https://pay.checkify.pro" async="" src="https://pay.checkify.pro/static/js/shopify.js"></script>
🙀 I found a mistake in the permissions configuration after generating the credentials. What should I do?
Just edit the permissions needed, save your changes on Shopify, and try one more time to submit app credentials on Checkify.
🙀 I decided to change the store's theme and Checkify now does not appear on my store. What can I do?
Every time you change or modify the theme of your store and start seeing the default checkout again, it is highly recommended to republish the script. Find the appropriate button in admin > Settings > Checkify script tab.
🙀 I have several stores. Should I open multiple Checkify accounts or everything could be managed in one account?
You need to open a new (separate) account for each store you want to connect to our product. However, you can add "+1", "+2", etc., to your basic (initial) email when setting up a new account. This way you identify yourself as an operator of multiple and related Checkify accounts. Also, you can use the same Stripe on multiple Checkify accounts.
🙀 I'm worried about the permissions I have granted to Checkify. What my store data will be used for?
We fully understand your concerns and always ask a merchant to share only the minimum of data we need to provide you with our service. All the data from your store that we process is secure, encrypted, and will be promptly removed from our databases in case you decide to disconnect Checkify and confirm the deletion (removal).
Moreover, our system will prevent you from connecting if you accidentally open (enable for us) more access than we actually need. Find more info about data processing and usage in our Privacy Policy.
🙀 How do I uninstall Checkify?
Learn how to uninstall Checkify in this guide. Don't remove (delete completely) if you wish to rejoin one day.