WordPress / WooCommerce – Openpay Payment Plugin

Integration Guide

Objectives and target audience

This guide describes how to install and configure Openpay Payment Plugin to WordPress version 5.x. In order to use Openpay payment method, WooCommerce version 3.x should be active on your ecommerce website.


What is WooCommerce Payment Plugin?

WooCommerce is a free to use plugin for WordPress. This converts a basic WordPress site into a Multi-dimensional eCommerce platform with a wide range of features, built on open source technology.

WooCommerce provides online merchants not only with a flexible shopping cart system, but also control over the look‐and‐feel of the content as well as the functionality of their online store.

WooCommerce can be fully integrated with Openpay’s online payment solutions. Installing and configuring the Hosted Payment Solution module of Openpay provide a simple, secure and convenient option to connect with Openpay’s online payment processing platform via WooCommerce.

Signing up for Openpay merchant account

In order to start taking payments through Openpay, you need to sign up and get approval for an Openpay merchant account. Once your application is approved, you can configure Openpay Hosted Payment Solution module and start taking payments.

Openpay provides a test account and users for training and testing purpose.

Installing and Configuring Openpay Payment Plugin


Before installing the Openpay module, make sure that your web server meets the following criteria:

  • WooCommerce should be pre-installed on your WordPress web server. The Openpay module is compatible with WordPress version 4.x and WooCommerce version 3.x. The installation procedure described here has been tested on WooCommerce version 3.x
  • Supported Web Servers: Apache / nginx
  • SSL: A valid security certificate is required to work over a secure channel (HTTPS) from the WordPress Admin Panel or while submitting the form data from the store‐front. Self‐signed SSL certificates are not supported
  • MySQL database with sample data
  • At least 5.6 or the later version of PHP, MySQL and web browser
  • Curl (version 7.20.0 ‐ 7.44.0)

Running WordPress on a Windows server

WordPress can be run on a Windows server, although this is not officially supported by WordPress. Please visit the WordPress website for details: https://wordpress.org

Installation Steps

To install the plugin, download the zip file.

Log in to your WordPress admin dashboard

Navigate from Dashboard to Plugin > Add New > Add Plugins (select the downloaded file) > Upload

Activate the plugin and you are set to go ahead

Admin Setup

Log in to your WordPress admin account

Navigate to WooCommerce > Settings > Payments > Openpay > Manage

  • Enable Openpay Payment Module
  • Payment from Specific Countries: Set it to Australia only
  • Enable Sandbox Mode for test purpose only
  • Title: Openpay
  • Description: Buy now. Pay smarter.
  • Jam Auth Token: Please enter Jam Auth Token provided by Openpay
    Use the Test Jam Token below for testing:
  • Click ‘Update Min – Max’ to run the min max amount
    (Order amount should be greater than minimum and less than maximum to enable Openpay payment method on the frontend of your site.)
  • Click ‘Save changes’ to save the settings.

WooCommerce Openpay Payment Plugin

To check Orders, go to: WooCommerce > Orders > (ANY ORDER)

How does Openpay work on your site

If the amount is greater than the Minimum Order Value and less than the Maximum Order Value which is set on admin configuration, it will allow the users to pay using Openpay Payment Method.

Click on the ‘Place Order‘ and it will be redirected to the Openpay Payment Gateway page. This will perform a HTTP POST request to Openpay.

Openpay Plan Creation

If the customer is already registered with Openpay, the following screen will be displayed:

If you do not have an Openpay account, you need to create one.

We do not send Email code on training mode please use 123456 for verification.

We do not send SMS on training mode please use 111111 for verification.

If the customer continues to login, then the following page will be displayed:

If one clicks on Submit Plan, and the plan is successful, the browser will be redirected to your site with “Your order has been placed” message.

Demo Site

Shows the placement of all the Openpay widgets and assets. You can test an Openpay plan creation on this site.

Testing Credentials

This section provides the credentials for test user and test merchant account on Openpay Training Environment to create and check your Openpay plan.

Test JamAuthToken for Testing

JamAuthToken: 30000000000001179|800a3185-1323-4509-a215-532954e99db6

Test User for creating a plan on Openpay

Username: testwordpress@xx.yy
Password: Testing123

Test Retailer’s Account to check plan created on Openpay’s Retailer’s Portal

Username: adminwoocom
Password: Test123

Please note: Openpay does not provide LIVE / Production test credentials. Our team is happy to test and certify your LIVE / Production site.

WordPress Order Status

Pending Payment
If somehow a payment was declined or not completed after order placement, the order will be “Pending Payment”. This could be due to a session timeout or also be an abandoned cart. Do not dispatch Openpay order on this status.

After successful payment order status will be ‘Processing’.

If the order is shipped or dispatch by admin, they can change the order status to complete.

If the order is cancelled by an admin user.

If the order is fully refunded by an admin user, the order status changes to Refunded.

Below is the detailed order status to share with your staff who look after orders, dispatch, and refunds.


Dispatch, Shipping and Refund can be done easily from the admin panel of WordPress.

  • If the admin wants to ship the products, they can change the order status to ‘Shipped‘ and submit the status

  • Full RefundAdmin can initiate the refund for a single order from the backend
    (Below is just an example refund amount may vary)

    To process a refund, click on WooCommerce > Orders > Select the order to be refunded > Click on Refund

    Enter the Refund amount > Click on Refund $XX.XX via Openpay
    Enter the Reason for refund is optional

  • Partial RefundAdmin can initiate the refund for a single order from the backend
    (Below is just an example refund amount may vary)

    To process a refund, click on WooCommerce > Orders > Select the order to be refunded > Click on Refund

    Enter the Partial Refund amount > Click on Refund $XX.XX via Openpay
    Enter the Reason for refund is optional

    Under Orders it shows the partially refunded amount.


Navigate to Dashboard > Plugins > Openpay Payment Method for WooCommerce > Deactivate

Version Control Table

# Date Version Description
1 September 2017 1.1 Created payment plugin
2 July 2019 5.2 Updated payment plugin to API 5.2
3 September 2019 5.5 Updated payment plugin to API 5.5
4 July 2020 5.5.1 Message Updated on Thank you page reload
5 August 2020 5.5.2 Thank you page, Online payment capture twice run, order status issue fixed
6 September 2020 5.5.3 Openpay Logo update
7 October 2020 5.5.4 Online payment capture twice run status code change
8 November 2020 5.5.5 Logo Update