Direct Server API

(Version 1.3.0)
(previously known as Seamless Payment API)
Last updated on 30 Nov 2016

Revision History

Date Version Author(s) Description

24/06/2015 1.0.0 Frankie Document creation

09/07/2015 1.0.1 Frankie Update payment flow

21/07/2015 1.0.2 Frankie Update payment request

29/07/2015 1.0.3 Frankie Add Channel

04/08/2015 1.0.4 Frankie Update Channel

05/08/2015 1.0.5 Frankie Update Document

21/08/2015 1.0.6 Frankie Add Channel

28/08/2015 1.0.7 Frankie Add Channel

29/09/2015 1.0.8 Frankie Update Appendix C

02/11/2015 1.0.9 Frankie Update Appendix C

11/04/2016 1.1.0 Frankie Add Channel

16/08/2016 1.2.0 tekjau Restructure and removing duplicate part

of the document that overlaps with official
API, and rename it from “Seamless
Payment API” to “Direct Server API”

01/09/2016 1.2.1 Clement Added CC_Token and “mobile://” value

type on returnUrl for mobile flag

1
25/10/2016 1.2.2 Hairi Adding more FPX channels

26/10/2016 1.2.3 Amalina Adding Vietnam channels

27/10/2016 1.2.3 tekjau Rectify request URL link

30/11/2016 1.3.0 tekjau Truncated transaction ID for 7e

2
 Table of Contents
Introduction
Direct Server API Flow

Payment Request Parameters (Merchant to MOLPay)

Payment Response Parameters (MOLPay to Merchant)

SAMPLE - Payment Response

ERROR CODES

Payment Status Notification

Appendix A : Data Type Details

Appendix B : M/O Details

Appendix C: Channel Details

3
Introduction
Direct Server API (previously known as Seamless Payment API) allows merchant to initiate
payment request through post data. Merchant will redirect customer/user based on the url
response back to merchant. Merchant will require to initiate direct status inquiry once user
redirect from channel to merchant application.

If merchant is to obtain credit card data directly from buyer (not entering on bank or MOLPay
hosted page or URL), then merchant must be PCI-DSS compliant in order to proceed.
Otherwise assessment fee might be imposed by the brands, i.e. Visa or MasterCard.

This is a server-to-server call API that merchant or developer will have more control on the
checkout experience and need to manage on the frontend user interface. Improper integration
might cause higher drop rate on the channel.

The other 2 integration methods are:

1) Hosted payment page: implementation guide can be found in official API
2) Seamless Integration: it is in between server-to-server request and hosted page, channel
page is prompt to the buyer using JavaScript snippet code from
https://github.com/MOLPay/Seamless_Integration

4
Direct Server API Flow

5
Payment Request Parameters (Merchant to MOLPay)
Merchant sends HTTPs POST payment request parameter to MOLPay.

REQUEST URL: ​https://www.onlinepayment.com.my/MOLPay/API/seamlesspayment/index.php

No Field Name Data Type M/O/C Description

(Size)

1. MerchantID as{1..32} M Merchant ID provided by MOLPay

2. ReferenceNo ans{1..32} M Merchant Unique Transaction / Order / Billing / Reference No.

3. TxnType a{4} M SALS, AUTS(FOR CREDIT-CARD ONLY)

4. TxnChannel ans{0.30} M (Refer to Appendix C)

5. TxnCurrency a{3} M eg. “MYR”, “THB”, “IDR”

6. TxnAmount a{10,2} M Transaction amount eg.”1.00”

7. CustName ans(1..128) M Customer name.

8. CustEmail ans(1..128) M Customer email.

9. CustContact ans(1..32) M Customer contact no.

10. CustDesc ans{1..200} M Customer/Merchant description.

10. Signature ans(1..32) M md5(TxnAmount.MerchantID.ReferenceNo.Verifykey)

11. ReturnURL ans{1..200} O Merchant payment response page

(message via browser). [Allowed domain only]
For mobile flag, use “mobile://”

12.. CC_PAN n{15..16} O For credit-channel only. Credit-card number.

13. CC_CVV2 n{3..4} O For credit-channel only. Credit-card CVV

14. CC_MONTH n{2} O For credit-channel only. Valid Month

15. CC_YEAR n{4} O For credit-channel only. Valid Year

16. CC_TOKEN n{16} O Token for credit card

17. BCARD_NO n{10} O For BCard redemption only. Last 10-digit BCARD no.

18 BCARD_PIN n(6) O For BCard redemption only. 6-digit BCARD PIN

6
Payment Response Parameters (MOLPay to Merchant)
MOLPay will return response in json format to merchant.

No Field Name Data Type M/O/C Description

(Size)

1. MerchantID a{1..32} M Merchant ID provided by MOLPay

2. ReferenceNo an{32} M Merchant Unique Transaction / Order / Billing / Reference No.

3. TxnType a{4} M SALS or AUTS

3. TxnID ans{1..100} M MOLPay Transaction ID.

4. TxnChannel ans{0.30} M Channel (Refer to Appendix B for channel)

5. TxnCurrency a{3} M eg. “MYR”, “THB”, “IDR”

6. TxnAmount a{10,2} M Transaction amount eg.”1.00”

7. TxnData a{1..1000} M Refer to TxnData below.

8. payTxnID s{7} C Truncated TxnID applicable for 7-eleven only.

TxnData
- RequestURL ​(Merchant is required to ​REDIRECT/POPUP​ user to provided url)
- RequestMethod ​(Merchant is required to follow type of method to be submit [​GET/POST​])
- RequestType ​(Merchant is required to follow the type ​REDIRECT/POPUP/RESPONSE​)
- RequestData ​(Merchant is required to submit provided data during ​REDIRECT/POPUP​)

Note: RequestType ​RESPONSE​ ​is the final result of that payment.

Refer to below for sample response TxnData.

7
SAMPLE - Payment Response

ERROR CODES
Please refer MOLPay API Spec for Merchant (section ERROR CODES)

8
Payment Status Notification

Please refer to the same section name in official API document. Merchant will need to
implement at least 2 endpoints (notification URL and callback URL, both with IPN or ACK
function).

WARNING: Please note that multiple payment notifications (either from ​return URL, ​notification
URL or ​callback URL) for single transaction is possible but this does not mean that the buyer
has paid twice or multiple times.

9
Appendix A : Data Type Details

No Code Description

1 a Letters, A-Za-z

2 n Numbers, 0-9

3 s Symbols, .:|?*,!&_-

4 {x} Fixed length x

5 {y..x} Length range: y – x

6 {y,x} Number range: 0-9. 0-9

Appendix B : M/O Details

No Code Description

1 M Mandatory field.

2 O Optional field.

3 C Conditional field.

10
Appendix C: Channel Details
Channel Country Type CUR Type Value Display Name RequestMethod RequestType Min
Amount

Credit-Card - CC MYR SALS,AUTS credit - POST REDIRECT > 1.00

Bcard - EW MYR SALS pointbcard BCARD POST REDIRECT > 1.00

Points

MOLPoints - EW MYR SALS MOLPoints MOLPoints GET REDIRECT > 1.00

FPX MY IB MYR SALS fpx FPX POST REDIRECT > 1.00

FPX MY IB MYR SALS fpx_mb2u Maybank2u POST REDIRECT > 1.00

Maybank

FPX CIMB MY IB MYR SALS fpx_cimbcli CIMB Clicks POST REDIRECT > 1.00
cks

FPX AMB MY IB MYR SALS fpx_amb Am Online POST REDIRECT > 1.00

FPX HLB MY IB MYR SALS fpx_hlb HLB Connect POST REDIRECT > 1.00

FPX PBB MY IB MYR SALS fpx_pbb PBeBank POST REDIRECT > 1.00

FPX RHB MY IB MYR SALS fpx_rhb RHB Now POST REDIRECT > 1.00

FPX BIMB MY IB MYR SALS fpx_bimb Bank Islam POST REDIRECT > 1.00

FPX OCBC MY IB MYR SALS fpx_ocbc OCBC Bank POST REDIRECT > 1.00

FPX SCB MY IB MYR SALS fpx_scb Stand Chart POST REDIRECT > 1.00
Bank

FPX_ABB MY IB MYR SALS fpx_abb Affin Bank POST REDIRECT > 1.00

Maybank MY IB MYR SALS maybank2u Maybank2u GET POPUP > 1.00

CIMB Bank MY IB MYR SALS cimb CIMB Clicks POST POPUP > 1.00

RHB Bank MY IB MYR SALS rhb RHB Now POST POPUP > 1.00

HLB Bank MY IB MYR SALS hlb HLB Connect POST POPUP > 1.00

AmBank MY IB MYR SALS amb Am Online GET POPUP > 1.00

Affin Bank MY IB MYR SALS affin-epg Affin Online POST POPUP > 2.00

Public Bank MY IB MYR SALS publicbank PBeBank POST POPUP > 1.00

Bank Islam MY IB MYR SALS bankislam Bank Islam POST POPUP > 1.00

7-eleven MY OTC MYR SALS cash 7-11 POST REDIRECT > 1.00
stores MOLPayCash

Petronas MY OTC MYR SALS epay e-Pay POST REDIRECT > 1.00
epay

SCB Bank TH IB THB SALS TH_SCBPN The Siam GET REDIRECT > 10.00

11
 Commercial
Bank

KTB Bank TH IB THB SALS TH_KTBPN Krung Thai GET REDIRECT > 10.00
Bank

BBL Bank TH IB THB SALS TH_BBLPN Bangkok Bank GET REDIRECT > 10.00

BAY Bank TH IB THB SALS TH_BAYPN Krungsri Bank GET REDIRECT > 10.00

Paysbuy TH OTC THB SALS TH_CASH Convenience POST POPUP > 10.00
CASH Store

Indonesia ID ATM IDR SALS ATMVA ALTO , Prima, POST POPUP >
ATM ATM Bersama 10000.0
0

Nganluong VN IB VND SALS nganluong Nganluong GET REDIRECT >

2000.00

Dragonpay PH IB/OTC PHP SALS dragonpay Dragonpay GET REDIRECT > 50.00

eNETS SG IB SGD SALS enetsD SG eNETS POST REDIRECT > 5.00

VTC-Pay VN IB VND SALS vtcpay-ewal VTC-Pay GET REDIRECT >

EW let 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-ewal VTC-Pay GET REDIRECT >

EW & Bank letbank 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-ewal VTC-Pay GET REDIRECT >

EW & letcredit 10000.0
Credit Card 0

VTC-Pay VN IB VND SALS vtcpay-bank VTC-Pay GET REDIRECT >

Banks 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-credi VTC-Pay GET REDIRECT >

Credit Card t 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-bank VTC-Pay GET REDIRECT >

Bank & credit 10000.0
Credit Card 0

VTC-Pay VN IB VND SALS vtcpay-vietc VTC-Pay GET REDIRECT >

Vietcomban ombank 10000.0
k 0

VTC-Pay VN IB VND SALS vtcpay-tech VTC-Pay GET REDIRECT >

Techcomba combank 10000.0
nk 0

VTC-Pay VN IB VND SALS vtcpay-mb VTC-Pay GET REDIRECT >

MB 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-vieti VTC-Pay GET REDIRECT >

Vietinbank nbank 10000.0

12
 0

VTC-Pay VN IB VND SALS vtcpay-agri VTC-Pay GET REDIRECT >

Agribank bank 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-don VTC-Pay GET REDIRECT >

DongABank gabank 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-ocea VTC-Pay GET REDIRECT >

Oceanbank nbank 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-bidv VTC-Pay GET REDIRECT >

BIDV 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-shb VTC-Pay GET REDIRECT >

SHB 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-vib VTC-Pay GET REDIRECT >

VIB 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-mari VTC-Pay GET REDIRECT >

MaritimeBa timebank 10000.0
nk 0

VTC-Pay VN IB VND SALS vtcpay-exim VTC-Pay GET REDIRECT >

Eximbank bank 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-acb VTC-Pay GET REDIRECT >

ACB 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-hdb VTC-Pay GET REDIRECT >

HDBank ank 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-nam VTC-Pay GET REDIRECT >

NamABank abank 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-saig VTC-Pay GET REDIRECT >

SaigonBank onbank 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-saco VTC-Pay GET REDIRECT >

Sacombank mbank 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-vieta VTC-Pay GET REDIRECT >

VietABank bank 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-vpba VTC-Pay GET REDIRECT >

VPBank nk 10000.0
0

13
 VTC-Pay VN IB VND SALS tienphongb VTC-Pay GET REDIRECT >
TienPhong ank 10000.0
Bank 0

VTC-Pay VN IB VND SALS vtcpay-seaa VTC-Pay GET REDIRECT >

SeaABank bank 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-pgb VTC-Pay GET REDIRECT >

PGBank ank 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-navi VTC-Pay GET REDIRECT >

Navibank bank 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-gpb VTC-Pay GET REDIRECT >

GPBank ank 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-baca VTC-Pay GET REDIRECT >

BACABAN bank 10000.0
K 0

VTC-Pay VN IB VND SALS vtcpay-phu VTC-Pay GET REDIRECT >

PHUONGD ongdong 10000.0
ONG 0

VTC-Pay VN IB VND SALS vtcpay-abb VTC-Pay GET REDIRECT >

ABBANK ank 10000.0
0

VTC-Pay VN IB VND SALS vtcpay-lienv VTC-Pay GET REDIRECT >

LienVietPos ietpostbank 10000.0
tBank 0

VTC-Pay VN IB VND SALS vtcpay-bvb VTC-Pay GET REDIRECT >

BVB 10000.0
0

SALS : Sales, one time charge

AUTS : Authorize, pre-authorization or to hold the credit
CUR : Currency
IB : Internet Banking
OTC : Over the counter / Cash Payment / Kiosk Payment
ATM : ATM Transfer
CC : Credit Card
EW : E-wallet

14