All Collections
Getting started with Checkify
Checkify: installation instructions
Checkify: installation instructions

This article will help you connect Checkify to your Shopify store after Shopify's update dated January 24, 2022.

Updated over a week ago

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 Apps and sales channels (in Settings menu) > Develop apps.

Then click "Allow custom app development" button.

2. Click "Create an app" button

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

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 giving the permissions, press the "Install" 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.

Did this answer your question?