WooCommerce

The Shift WooCommerce plugin allows you to offer customers Shift in your WooCommerce store. You need to be a Shift customer to enable the plugin for your eCommerce platform.

Prerequisites

WordPress Version

The WordPress version must be 5.8.0 or greater to integrate with Shift.

WooCommerce

VersionThe WooCommerce version must be 5.9 or greater to integrate with Shift.

Currency

Shift supports Australian Dollar only.

Access credentials

Please contact your Shift Account Manager or Partnership Manager to discuss your eCommerce requirements and access the plugins, and API Test and Live credentials.

Installation steps

Download the .zip file received from Shift
The WordPress admin panel will open. Go to Plugins
Click Add New
Upload the .zip file as per the instructions on the screen
When successful installation is confirmed, activate the plugin
Configure settings

Configuration

Navigate to WooCommerce tab on the left side menu
Select > Settings
Select > Payments
Scroll down to the Shift option
Select > Manage
Add the Shift credential fields (Contact your Shift Account Manager or Partnership Manager for your API keys and add to the Shift credential fields)

Name	Description
Enable/Disable	Enables or disables the plugin on the merchant store.
API Key	The API Key that will be used to call the Shift API. This will be generated by Shift and will be provided by your Shift Account Manager or Partnership Manager.
Merchant ABN	The Australian Business Number of the merchant.
Test Mode	Enables whether the plugin will be used for testing or production environment.
Checkout Method	Controls whether the plugin will use the widget or redirect for the checkout confirmation experience.
Product Code	The Shift Product Code to be used for checkouts. The following products are predefined in the plugin: Equipment Line Shift Trade
Webhook Secret	The secret that will be used for verifying the webhook event signature. The plugin will expose the webhook. This will be generated by Shift. See below ‘How to Determine the Shift Payment Plugin Webhook URL’ for more info
Webhook Timestamp Tolerance	Use this value for tolerance validation in seconds. Default to 180 seconds.
Send Exception Logs to Shift	Sends exception logs to Shift email automatically when an error has occurred with the payment.

How to determine the Webhook URL of the Shift Plugin

To determine the webhook URL of the plugin, you need to know the base store URL. You can find the base URL by navigating to Magento Admin Dashboard > Stores > Configuration > General > Web > Base URLs.
Once you know the base store URL, you can append /wp-json/gateway/v1/shift-callback/confirm

Examples:

Store URL	Webhook URL
https://shift-wp-sandbox.azurewebsites.net	https://shift-wp-sandbox.azurewebsites.net/wp-json/gateway/v1/shift-callback/confirm
https://abc.com/my-store	The API Key that will be used to call the Shift API. This will be generated by Shift and will be provided by your Shift Account Manager or Partnership Manager.

Configuration Credentials

Don’t have your configuration details yet? Please contact your Shift Account Manager or Partnership Manager. Shift will require your Test environment URL and the details of the individuals (name, email, mobile phone) who will be accessing both Test and Production environments.

Shift will then provide the following Test credentials:

Test API keys,
Test login instructions.

Go live

Once tests have been run in Test mode to trial the API keys and the test results are successful, then Shift will provide the Live configuration credentials.

Switch to Live mode.
Start offering Shift to your customers.