Web
Web Integrations

WooCommerce Plugin

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

This version of the Judopay WooCommerce plugin uses Judopay's Web Payments solution, to take online card payments as well as ApplePay™ and GooglePay™. 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/

permalinks

post name


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.

Go to the WordPress Plugins section Select Add New

add new plugin


Select Upload Plugin Click Choose File

choose plugin file


Locate the judopayhosted.zip file, then click Install Now

install plugin


Click Activate Plugin to activate the plugin

Document image


The installation is now complete.



Configure WooCommerce

In plugins for WooCommerce Click Settings

woocommerce settings


Click on the Payments tab

woocommerce configuration


Toggle the Enabled button to enable Judopay Hosted Gateway.

To configure your Judopay Plugin Details, click Manage

enable plugin



Configure the Judopay Plugin

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

configure plugin


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 ([email protected]) 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 [email protected] Sign up for a free Sandbox Account here.



Checkout View

place order

pay now



Success and Failure URLs

  • Once the plugin is set up, login to portal.judopay.com and set up your success 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.