Shopify updates its APIs to ensure the best possible experience and operations for merchants. Every three months, on average, they deprecate one version and add newer versions.
If you received an email from Shopify Support / Apps Team or see a notification in your store admin interface with the below-given text, you must adjust your Checkify custom app to ensure proper operation.
Subject: [Action required] A developer needs to update your custom apps and/or admin webhooks
The interface of admin.checkify will also start displaying a similar message:
All you need to do is simply change one setting in your app's setup.
1. How to change webhooks version on Dev apps integration (new)
Dev apps require a new version release whenever you need to update the configuration. To ensure your webhooks are current, please follow the steps below:
Access your dev app: Visit your Shopify dev dashboard and select your current app.
Create a version: Select the Versions menu item and click the Create a version button.
Update API version: Scroll down to the Webhooks API Version dropdown menu.
Select and Release: Pick the most recent stable version and click the Release button.
Confirm Release: Optionally, provide a name for this version, then confirm your action by clicking Release again.
Refer to the full installation guide if you encounter any issues.
2. How to change webhooks version on Custom apps (legacy)
Please follow the instruction below to update the version to a more recent more:
In your Shopify store admin open Settings > Apps > Develop apps.
Click on your custom checkout app, usually called Checkify, or any other name you previously assigned.
3. In your custom app, select Configuration tab and click the Edit button in the Admin API integration section. If you used a Private app to install Checkify then skip this item and go to Step 4.
4. Scroll down and find Webhook subscriptions block. Then select API Version higher than your current version, but not the Release candidate.
If you see that you already have an optimal version selected (not too old, not too new), then do not change anything. In such case you can simply close this guide.
5. Click Save to confirm the action.
That's it! You did everything to ensure smooth and secure operation of the custom checkout app. Once the update described above is complete, the banner with the warning in admin.checkify will disappear after the first launch (initiation) of the checkout in this new configuration.
In future you may still receive a warning from Shopify with subject [Action required] Update your Shopify apps before (date). The example of such email is given below:
As oftentimes, such emails may be sent by mistake. Nothing can stop working all of a sudden, and such a letter can be safely ignored.
P.S.: A useful hint
If you are experiencing problems at any of the steps described above, you can simply create a new version of the app for Checkify's operation. This process will be similar to what you have already done successfully during the initial installation. It is described here.
The advantage of such an approach is that all the recent API updates by Shopify are offered and applied automatically, webhooks will be renewed / re-written.
Alternatively, you may contact support.