WooCommerce Plugin

This version of the Judopay WooCommerce plugin uses Judopay's Web Payments solution, to take online card payments as well as ApplePay™ and GooglePay™.

This plugin is provided on an as-is basis, not on a support basis.

The plugin supports 3D Secure 2.0 transactions, if the issuing bank requires.

 

PreRequisites

Below are the versions of systems this plugin has been developed and tested on. Although other versions may work, they are not guaranteed:

  • WordPress: Version 6.2.2

  • WooCommerce: Version 7.9.0

  • PHP: Version 8.1.2

  • Contact Developer Support for the WooCommerce plugin file.

If you are not using these versions the lower versions may work but are not guaranteed. Judopay will not be making any modifications to accommodate lesser working versions.
Equally, any new versions that may cause functionality to fail will be looked at on a best-case scenario.

 

WordPress Configuration Requirement

It is important that the Permalink configuration within WordPress is set to Post name.

For example:

https://www.yourdomain.com/wordpress/sample-post/

 

Ensure you are careful when changing this, if any other plugins require a different configuration this may cause issues with other plugins.
If you are unsure then do not use this plugin.

 

Installation

Ensure you have WooCommerce installed and working as desired.

 

  1. Go to the WordPress Plugins section

  2. Select Add New

  1. Select Upload Plugin

  2. Click Choose File

  1. Locate the judopayhosted.zip file, then click Install Now

  1. Click Activate Plugin to activate the plugin

The installation is now complete.

 

Configure WooCommerce

  1. In plugins for WooCommerce

  2. Click Settings

  1. Click on the Payments tab

  1. Toggle the Enabled button to enable Judopay Hosted Gateway.

  1. To configure your Judopay Plugin Details, click Manage

 

Configure the Judopay Plugin

Sandbox mode is enabled by default and will use the Sandbox Account.

When you are ready to go live and have a live account, de-select Enable Sandbox Mode to receive live payments.

Contact your sales adviser (sales@judopayments.com) in order to set up a live transacting account.

 

Debug Mode will log to the WordPress log file if required.

This will not log card details in any way.

  • apiToken: This your unique API Token from your Judopay Account.

  • apiSecret: This your unique API Secret from your Judopay Account.

  • judoId: This is your unique JudoId.

 

For assistance with your Judopay Account, contact help@judopayments.com

Sign up for a free Sandbox Account here.

 

Checkout View

 

Success and Failure URLs

  • Once the plugin is set up, login to portal.judopay.com and set up your success URL and failure URLs.

  • The API token used by the plugin needs to use the following as its success / failure URL: 

     https://www.yoursite.com/wc-api/judopay_webhook

    • Where yoursite.com is your WordPress site.

  • This is the return URL for Judopay to call the WooCommerce site and update the transaction status.