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.

Introduction

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

Prerequisites

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 accountNavigate to WooCommerce > Settings > Payments > Openpay > Manage

Active : Yes
Title: Openpay
Description: – Buy now. Pay smarter.
Mode: If the website is live then set it to ‘Production’. If the website is under construction or under development, then set it to ‘Sandbox’.
Region: Select Australia.
Openpay Username: (For testing use the username below, else see your Integration credentials document for Production username provided by Openpay)
3-370
Openpay Password: (For testing use the password below, else see your Integration credentials document for Production password provided by Openpay)
4E464DBA-3A97-4314-BDEA-A90B8EF9CD12
Minimum Checkout Value: Click on ‘RunMin/Max’ button, the values will be pulled from the system.
Maximum Checkout Value: Click on ‘RunMin/Max’ button, the values will be pulled from the system.
Get Min/Max Values: Click ‘Run Min/Max!’ to get the min-max amount.
(Order amount should be greater than the minimum and less than maximum to enable Openpay payment method on your site.)
Note: Verify the min-max amount when installing Production credentials from the credentials document provided by Openpay.
Update Pending Order older than: Default integer number used for the Update Order status cron job
Disabled Categories: Add the Categories you don’t wish to use Openpay for.
Disabled Products: Add product IDs with a comma separator if you don’t want Openpay available on certain products
Click ‘Save changes’ to save the settings.

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

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.

Checkout WordPress

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 AUTH Token for Testing

Openpay Username: 3-370
Openpay Password: 4E464DBA-3A97-4314-BDEA-A90B8EF9CD12

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

https://retailer.myopenpay.com.au/training
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

Processing
After successful payment order status will be ‘Processing’.

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

Cancelled
If the order is cancelled by an admin user.

Refunded
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.

Refund

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 Refund
Admin 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 RefundEnter the Refund amount > Click on Refund $XX.XX via Openpay
Enter the Reason for refund is optional
Partial Refund
Admin 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 RefundEnter 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.