How to set up Safepay for Woocommerce

Getting Started

To get started, you can download and install the plugin. Click here to download the latest plugin and follow the instructions on the page to install the plugin. Please be sure to activate the plugin when you have installed it.

First, download the plugin zip file from the Github then go to Plugins and then add the new plugin by uploading:

Click on Install Now to install the plugin then Activate the plugin

After you have installed the plugin, you need to go to the WooCommerce Plugin Settings on the menu tab of your WordPress site and click the Payment tab. This will show a tab containing all the Payment options on your site. If you have installed the plugin correctly, you should see Safepay on that list. This is where you can configure the Safepay Plugin.

Safepay WooCommerce Plugin Settings

Here we will discuss all the settings you'll find in your Safepay WooCommerce Plugin and how they should be set in order for your plugin to function properly.

1. Enable Safepay: Ensure that the Enable Safepay checkbox is checked so that  Safepay can show up on the list of Payment options during checkout

2. Sandbox Mode: Safepay provides test parameters that allow you to simulate a transaction without using real money. If you check to enable, Safepay will be using your sandbox API keys to parse the payments, meaning that the orders processed then will be done with test cards, no real money is exchanged therefore no real value should be delivered.

   If you check to enable test mode, ensure that you have your test API keys, if not, make sure the live API keys are properly entered. If you don't do these, Safepay will not show in your list of plugins.

3. Sandbox API key: Kindly follow this link to your Sandbox Safepay Dashboard Settings to find your API key. Copy the key and enter them in the right fields in the plugin settings.
4. Production API key: Kindly follow this link to your Production Safepay Dashboard Settings to find your API key. Copy the key and enter them in the right fields in the plugin settings.
5. Production Webhook Secret key: Kindly follow this link to your Production Safepay Developer Settings to find your secret key. Copy the key and enter them in the right fields in the plugin settings.
6. Sandbox Webhook Secret key: Kindly follow this link to your Sandbox Safepay Developer Settings to find your secret key. Copy the key and enter them in the right fields in the plugin settings.

Additional Fields:

Title: This is the method name that will show on orders so that you can easily distinguish Safepay transactions on the order level like below:

Description: This field is the label that will appear on the Safepay Checkout method on the woo-commerce order checkout screen, its recommended to keep Pay securely via credit  or debit cards

Safepay on Checkout

If all the settings above are done correctly, you should find Safepay on your checkout page's listed under enabled payment options.

If you do not find Safepay on the Payment method options, please go through the settings again and make sure that:

• You have enabled Safepay
• The entered API Keys are correct

woocommerce orders paid with Safepay

Orders created in your woocommerce admin that are paid for through Safepay will be created with the Safepay transaction reference code. Additionally, the tracker for each transaction will be saved as metadata on the order. When you click into an order, you will see details as follows:

The red underline shows the Safepay reference code for each transaction that can be found in your dashboard. Note that if the transaction was conducted with your sandbox API key, then the appropriate transaction will be found in your sandbox dashboard, whereas if the transaction was conducted with your production API key, the transaction will be found on your production dashboard.

Similarly, order notes will now be marked as "payment successful" with the Safepay Reference Code attached as well

If there is  any confusion please follow the detailed video tutorial below:

1. Disclaimer: Sandbox Mode Payment Status

   When our Woocommerce payment gateway plugin is in sandbox mode, payment statuses will display as "Pending" to prevent accidental order processing during testing. This ensures a secure development environment without real financial transactions. Users should switch to live mode for production to update payment statuses based on actual transactions. For questions or assistance, please contact our support team.