LiteShoper SecurePay FPX Plugin Guide

On this page

Overview
Requirements
Installation
Setup
Tutorial
Callback URLs
Troubleshooting

Overview

LiteShoper SecurePay (liteshop-securepay) integrates FPX online banking via SecurePay for Malaysian merchants. Customers select their bank at checkout and complete payment on the bank’s page.

Payment flow

Customer selects FPX (SecurePay) at checkout
Browser auto-submits a form to SecurePay
Customer completes banking on SecurePay
SecurePay POSTs to your callback (server) and return (browser)
LiteShoper verifies checksum → order confirmed

Requirements

LiteShoper Commerce
Store currency set to MYR (SecurePay hidden otherwise)
SecurePay merchant account (API UID, Auth Token, Checksum Token)
Marketplace license for liteshop-securepay

Installation

Purchase license on liteshoper.com.
Install liteshop-securepay from marketplace.
Set store currency to MYR: Commerce → Settings → General or currencies tab.

Setup

Admin: Commerce → Settings → SecurePay

Setting	Description
Enable SecurePay	Show FPX at checkout (MYR only)
Sandbox	Test environment
API UID	From SecurePay merchant panel
Auth Token	Encrypted in database
Checksum Token	For HMAC verification on callback/return
FPX model	B2C (individual) or B2B1 (business)

Tutorial

Enable sandbox + enter test credentials.
Ensure currency is MYR.
Place test order → select FPX → complete on SecurePay sandbox.
Confirm order confirmed in admin.

Callback URLs

Path	Purpose
`/commerce/securepay/callback`	Server notification (POST)
`/commerce/securepay/return`	Browser return (POST)
`/commerce/securepay/thank-you`	Order confirmation page (GET)

Troubleshooting

Not visible at checkout — currency must be MYR; plugin must be enabled.
Invalid checksum — wrong Checksum Token or tampered payload.
Payment verification failed — return URL issue or amount mismatch.
Unexpected API response — check SecurePay status page and credentials.

← All docs