Documentation

iPay88 Payment Gateway

iPay88 is a leading regional Payment Gateway Provider in South East Asia, owned by The Mobile88 Group of Companies. iPay88 offers merchants comprehensive online payment options such as credit/debit cards, bank transfers and alternative online payments such as Alipay and Philippines payment options. The payment process uses a redirect approach, customers will be redirected a secure iPay88 page where they will make a payment and then be returned to your store. The plugin supports iPay88 Malaysia and iPay88 Philippines gateways.

Installation

↑ Back to top

Download the .zip file from your WooCommerce account.
Go to: WordPress Admin > Plugins > Add New and Upload Plugin with the file you downloaded with Choose File.
Install Now and Activate the extension.

More information at Install and Activate Plugins/Extensions.

Setup and Configuration

↑ Back to top

Main steps to configure the iPay88 extension.

Log in to your WooCommerce store.
Go to WooCommerce > Settings > Checkout > iPay88.
Enable/Disable iPay88.
Choose which iPay88 gateway you are using.
Set your “Method Title” and “Description”. These options are seen on the checkout page.
Enter your iPay88 Merchant Code.
Enter your iPay88 Merchant Key.
Enable “Debug Log”, if you want to get a log of the request and response steps and parameters.
Save Changes.

Recommended: make a few test payments before you go live.

Settings

↑ Back to top

Enable/Disable
- Enable iPay88.
iPay88 Gateway In Use
- Which iPay88 gateway are you using? Currently supported are Malaysia and the Philippines.
Method Title:
- This controls the title which the user sees during checkout.
Description:
- This controls the description which the user sees during checkout.

Merchant Code:
- The Merchant Code provided by iPay88 and used to uniquely identify the Merchant.
Merchant Key:
- Provided by iPay88 OPSG and shared between iPay88 and merchant only.

Available Payment Types:
- Choose the payment types you can offer to the customers.
- The Payment types will be presented to the customer to pre-select on the Checkout page.
- Note: Do not choose any type to use the default selection on the iPay88 payment page.
- Note: Adding payment types to this setting does not mean that you can actually accept the payments. You need the payment type enabled in your iPay88 merchant account in order to accept payments for it.
Group Payment Types:
- This option will allow you to use the CSS packed with the plugin to group the payment types. It will group the payment types in three columns.
Enable Sandbox:
- Sandbox mode provides you with a chance to test your gateway integration with iPay88. The payment requests will be sent to the iPay88 sandbox URL.
- Disable to start accepting Live payments.
- The option is only available for iPay88 Philippines.
Debug Log:
- Recommended: Test Mode only.
- Debug log will provide you with most of the data and events generated by the payment process. Logged inside woocommerce/logs/ipay88.txt.

Supported iPay88 Malaysia payment types

↑ Back to top

Credit Card
Maybank2U
Alliance Online
AmOnline
RHB Online
Hong Leong Online
FPX
CIMB Click
Web Cash
MEPS Cash
Public Bank Online
PayPal
Celcom AirCash
Bank Rakyat
Affin Online
BSN Online
Bank Islam
UOB Bank Online
Hong Leong PEx+
Bank Muamalat
OCBC
Standard Chartered Bank
HSBC Online Banking
Kuwait Finance House
Boost Wallet
VCash

FAQ

↑ Back to top

I want to offer payment type [X] to my customers, but I don’t see it in the plugin supported methods. Is payment type [X] supported by the plugin?

↑ Back to top

Yes, the plugin will support all payment types that your iPay88 account supports. In order to support a payment type, you need to have it activated in your iPay88 account. If in any case, the payment type [X] is not available in the “Available Payment Types” setting of the plugin, you can leave the setting empty it will offer the customer to choose their payment method on the iPay88 payment page.

What do I provide to iPay88 before the integration?

↑ Back to top

iPay88 will ask you to provide:

Merchant Checklist: filled in with your merchant and integration information.
Request URL: the main page of your website, i.e., http://www.example.com/
Response URL: send with the payment parameters, so you do not need to provide them with one.

I am trying to do a test payment, but I get redirected to my home page. What should I do?

↑ Back to top

iPay88 accepts test payments with certain requirements. If those requirements are not met, then iPay88 will return you straight to your Response URL page. The requirements are:

Total MYR 1.00 ( min PHP 15.00 for iPay88 Philippines ): The total amount of the order should be exactly MYR 1.00
Currency MYR ( PHP for iPay88 Philippines ): The currency of the order should be MYR ( Malaysian ringgit )
Testmode: The test mode of the plugin should be turned ON.

I do not want to show the payment types under the iPay88 payment option. How can I hide them?

↑ Back to top

Don’t select a payment type from the “Available Payment Types” setting in the iPay88 plugin settings. This way only the description will be shown under the iPay88 payment option. The payment types are also available on the iPay88 payment page, so they are not mandatory to be present on your WC store checkout page.

I use the Super Store theme and the iPay88 payment options do not appear as they should on the checkout page.

↑ Back to top

You need to add some CSS for the options to appear correctly.

For element .checkout #order_review #payment ul li label img

Change float: right; to float: none;
Add display: inline-block;

Under @media only screen and (min-width: 768px):

For the element .form-row, change width: 48% to width: 100%

.checkout #order_review #payment ul li .payment_box { padding: .8em; }

Questions & Support

↑ Back to top

Have a question before you buy? Please fill out this pre-sales form. Already purchased and need some assistance? Get in touch the developer via the Help Desk.