Razer Merchant Services Seamless Integration v3.17 (non PCI) - RazerMS/Integration-RazerMS_JavaScript_Seamless_Integration GitHub Wiki

Seamless Integration

Latest update: 2018/04/03

  • Add new Payment Channel:
    • Artajasa, credit5, BAY_IB, creditO

Important

Please do not generate your vcode in JS as this will disclose the merchant verify key.

Getting started

Register your domain by email to our support: [email protected]

Include below javascript library in your web.

 <!-- jQuery (necessary for MOLPay Seamless JavaScript plugins) -->
 <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min.js"></script>
 <script src="https://www.onlinepayment.com.my/MOLPay/API/seamless/3.17/js/MOLPay_seamless.deco.js"></script>

Example 1

alt text

<!-- Button trigger MOLPay Seamless -->
<button type="button" id="myPay" class="btn btn-primary btn-lg" data-toggle="molpayseamless" data-mpsmerchantid="molpaymerchant" data-mpschannel="maybank2u" data-mpsamount="1.20" data-mpsorderid="TEST1139669863" data-mpsbill_name="MOLPay Technical" >Pay by Maybank2u</button>

Example 2

Seamless Demo Picture

View our demo or download.

Example 3 (Payment Timer Enable)

Seamless Demo Picture

View our demo or download.

Usage

The MOLPay seamless plugin process your button, via data attributes or JavaScript.

Via data attributes

Activate a MOLPay seamless without writing JavaScript. Set data-toggle="molpayseamless" on a controller element, like a button, along with a data-mpsamount="1.01" to set value.

<button type="button" data-toggle="molpayseamless">Pay by Maybank2u</button> 

Via JavaScript

Call a MOLPay seamless with id myPay with a single line of JavaScript:

$( document ).ready(function() {
     var options = { 
                    mpsmerchantid:"molpaymerchant",
                    mpschannel:"maybank2u", 
                    mpsamount:"1.20", 
                    mpsorderid:"TEST728638391", 
                    mpsbill_name:"MOLPay Technical", 
                    ...
                   }; 
                    
     $('#myPay').MOLPaySeamless(options)
});
                        

Options

Options can be passed via data attributes or JavaScript. For data attributes, append the option name to data-, as in data-mpsamount="".

Name Data Type (size) M/O Description
mpsmerchantid an{1..32} M Merchant login username provided by MOLPay.
mpschannel an{3..32} M Refer to Appendix C for more channel code.
mpsamount ns{10,2} M The transaction amount in one bill. Integer or up to 2 decimal points numeric value. Min accepted amount : 1.01
mpsorderid an{1..32} M Bill / Invoice no. provided by merchant.
mpsbill_name a{1..128} M Buyer name.
mpsbill_email ans{1..128} M Buyer email.
mpsbill_mobile n{1..128} M Buyer mobile contact number.
mpsbill_desc an{1..200} M Bill / Description provided by merchant / buyer.
mpscountry a{2} O Buyer country.
mpsvcode an{32} C This is the data integrity protection hash string provided by merchant.
mpscurrency a{3} O Payment currency, E.g. MYR, SGD, USD & etc.
mpslangcode a{2} O Default language, E.g. 'en' for default
mpsreturnurl ans{1..200} O Obsoleted. Used for multiple return URL. All URLs must be registered beforehand with MOLPay.
mpstimer n O Duration of payment. Value in minutes. Set 0 to disable this feature, append this to the pre-hashing vcode string if mpstimer is in used
mpstimerbox ans C Element id or class name to show the timer. Mandatory when timer is enable. E.g. #timercounter, .timercounter
mpscancelurl ans{1..200} C URL to redirect when the payment is time out. Mandatory when timer is enable. All payment request parameter will be return. Merchant is advice to implement requery at this page.
mpstokenstatus n[0/1] O To tokenized the transaction.
mpstcctype a{4} O Available value is SALS = Capture Transaction (Default), AUTH = Authorize Transaction
mpsextra a{8..65535} O Format:
NumOfMer#merA : amtA | merB : amtB | merC : amtC (without space) E.g:3#samsung:30.10|doorstep:120.00|senQ:15.99

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, value can be empty.
3. C Conditional

Appendix C: Channel details (mpschannel)

No Code Description Type Currency
1. affinonline Affin Bank(Affin Online) Online Banking MYR
2. amb Am Bank (Am Online) Online Banking MYR
3. bankislam Bank Islam Online Banking MYR
4. cimbclicks CIMB Bank(CIMB Clicks) Online Banking MYR
5. hlb Hong Leong Bank(HLB Connect) Online Banking MYR
6. maybank2u Maybank(Maybank2u) Online Banking MYR
7. pbb PublicBank (PBB Online) Online Banking MYR
8. rhb RHB Bank(RHB Now) Online Banking MYR
9. fpx MyClear FPX B2C (Maybank2u, CIMB Clicks, HLB Connect, RHB Now, PBB Online, Bank Islam Online Banking MYR
10. fpx_amb FPX Am Bank (Am Online) Online Banking MYR
11. fpx_bimb FPX Bank Islam Online Banking MYR
12. fpx_cimbclicks FPX CIMB Bank(CIMB Clicks) Online Banking MYR
13. fpx_hlb FPX Hong Leong Bank(HLB Connect) Online Banking MYR
14. fpx_mb2u FPX Maybank(Maybank2u) Online Banking MYR
15. fpx_pbb FPX PublicBank (PBB Online) Online Banking MYR
16. fpx_rhb FPX RHB Bank(RHB Now) Online Banking MYR
17. fpx_ocbc FPX OCBC Bank Online Banking MYR
18. fpx_scb FPX Standard Chartered Bank Online Banking MYR
19. fpx_abb FPX Affin Bank Berhad Online Banking MYR
20. fpx_abmb FPX Alliance Bank (Alliance Online) Online Banking MYR
21. fpx_uob FPX United Overseas Bank (UOB) Online Banking MYR
22. fpx_bsn FPX Bank Simpanan Nasional (myBSN) Online Banking MYR
23. fpx_kfh Kuwait Finance House Online Banking MYR
24. fpx_bkrm Bank Kerjasama Rakyat Malaysia Online Banking MYR
25. fpx_bmmb Bank Muamalat Online Banking MYR
26. fpx_hsbc Hongkong and Shanghai Banking Corporation Online Banking MYR
27. FPX_B2B MyClear FPX B2B (Maybank2e, BizChannel@CIMB, RHB Reflex, BizSmart, Bank Islam Online Banking MYR
28. FPX_B2B_ABB FPX B2B Affin Bank Online Banking MYR
29. FPX_B2B_AMB FPX B2B Ambank Berhad Online Banking MYR
30. FPX_B2B_BIMB FPX B2B Bank Islam Malaysia Berhad (BIMB) Online Banking MYR
31. FPX_B2B_CIMB FPX B2B BizChannel@CIMB (CIMB) Online Banking MYR
32. FPX_B2B_HLB FPX B2B HongLeong Connect Online Banking MYR
33. FPX_B2B_HSBC FPX B2B HSBC Online Banking MYR
34. FPX_B2B_PBB FPX B2B Public Bank Online Banking MYR
35. FPX_B2B_RHB FPX B2B RHB Reflex Online Banking MYR
36. FPX_B2B_UOB FPX B2B United Overseas Bank Online Banking MYR
37. FPX_B2B_KFH FPX B2B Kuwait Finance House Overseas Bank Online Banking MYR
38. FPX_B2B_DEUTSCHE FPX B2B Deutsche Bank Online Banking MYR
39. FPX_B2B_ABMB FPX B2B Alliance Bank Online Banking MYR
40. FPX_B2B_SCB FPX B2B Standard Chartered Bank Online Banking MYR
41. FPX_B2B_OCBC FPX B2B OCBC Bank Online Banking MYR
42. FPX_B2B_BMMB FPX B2B Bank Muamalat Online Banking MYR
43. FPX_M2E FPX Maybank2e Online Banking MYR
44. CIMB-VA CIMB Bank(Virtual Account) CIMB Clicks / ATM transfer for CIMB customers only MYR
45. cash-711 7-Eleven(MOLPay Cash) Physical Payment MYR
46. cash-epay e-pay Physical Payment MYR
47. WEBCASH WEBCASH WEBCASH MYR
48. PEXPLUS PEx+ Direct Internet Banking MYR
49. jompay MOLPay ATM Indirect Internet Banking MYR
50. Cash-Esapay Cash Esapay Physical Payment MYR
51. credit Credit Card/ Debit Card Credit Card MYR
52. mbbezpay Maybank EZ Pay Credit Card MYR
53. credit3 Credit Card/ Debit Card Multi Currency Credit Card Multi Currency
54. crossborder Credit Card/ Debit Card Multi Currency Credit Card Multi Currency
55. paypal PayPal Credit Card Multi Currency
56. Point-BCard Bcard points Wallet (BCard Loyalty Redemption) -
57. ATMVA ATM Transfer via Permata Bank Physical Payment IDR
58. enetsD eNETS Online Banking SGD
59. singpost Cash-SAM Physical Payment SGD
60. paysbuy PaysBuy Indirect Internet Banking and Physical Payment THB
61. TH_PB_SCBPN Paysbuy SCBPN Direct Internet Banking THB
62. TH_PB_KTBPN Paysbuy KTBPN Direct Internet Banking THB
63. TH_PB_BBLPN Paysbuy BBLPN Direct Internet Banking THB
64. TH_PB_BAYPN Paysbuy BAYPN Direct Internet Banking THB
65. TH_PB_CASH Paysbuy CASH Physical Payment THB
66. dragonpay Dragonpay Indirect Internet Banking and Physical Payment PHP
67. polipayment POLi Payment Indirect Internet Banking AUD
68. UPOP China Union pay Indirect Internet Banking and Physical Payment MYR, USD, CNY
69. alipay Alipay.com Third-party Online Payment Platform CNY
70. vtcpay-ewallet VTC Pay Channels (E-Wallet) Online Banking VND, USD
71. vtcpay-bank VTC Pay Channels (Banks) Online Banking VND, USD
72. vtcpay-credit VTC Pay Channels (Credit Card) Online Banking VND, USD
73. vtcpay-ewalletbank VTC Pay Channels (E-Wallet & Banks) Online Banking VND, USD
74. vtcpay-ewalletcredit VTC Pay Channels (E-Wallet & Credit Card) Online Banking VND, USD
75. vtcpay-bankcredit VTC Pay Channels (Banks & Credit Card Online Banking VND, USD
76. vtcpay-vietcombank VTC Pay Channels (Vietcombank) Online Banking VND, USD
77. vtcpay-techcombank VTC Pay Channels (Techcom Bank) Online Banking VND, USD
78. vtcpay-mb VTC Pay Channels (MB) Online Banking VND, USD
79. vtcpay-vietinbank VTC Pay Channels (Vietin Bank) Online Banking VND, USD
80. vtcpay-agribank VTC Pay Channels (Agribank) Online Banking VND, USD
81. vtcpay-dongabank VTC Pay Channels (Dong A Bank) Online Banking VND, USD
82. vtcpay-oceanbank VTC Pay Channels (Ocean Bank) Online Banking VND, USD
83. vtcpay-bidv VTC Pay Channels (BIDV) Online Banking VND, USD
84. vtcpay-shb VTC Pay Channels (SHB) Online Banking VND, USD
85. vtcpay-vib VTC Pay Channels (VIB) Online Banking VND, USD
86. vtcpay-maritimebank VTC Pay Channels (Maritime Bank) Online Banking VND, USD
87. vtcpay-eximbank VTC Pay Channels (Eximbank) Online Banking VND, USD
88. vtcpay-acb VTC Pay Channels (ACB) Online Banking VND, USD
89. vtcpay-hdbank VTC Pay Channels (HD Bank) Online Banking VND, USD
90. vtcpay-namabank VTC Pay Channels (Nam A Bank) Online Banking VND, USD
91. vtcpay-saigonbank VTC Pay Channels (Saigon Bank) Online Banking VND, USD
92. vtcpay-sacombank VTC Pay Channels (Sacombank) Online Banking VND, USD
93. vtcpay-vietabank VTC Pay Channels (Viet A Bank) Online Banking VND, USD
94. vtcpay-vpbank VTC Pay Channels (VP Bank) Online Banking VND, USD
95. vtcpay-tienphongbank VTC Pay Channels (TP Bank) Online Banking VND, USD
96. vtcpay-seaabank VTC Pay Channels (Sea Bank) Online Banking VND, USD
97. vtcpay-pgbank VTC Pay Channels (PG Bank) Online Banking VND, USD
98. vtcpay-navibank VTC Pay Channels (Navi Bank) Online Banking VND, USD
99. vtcpay-gpbank VTC Pay Channels (GP Bank) Online Banking VND, USD
100. vtcpay-bacabank VTC Pay Channels (Bac A Bank) Online Banking VND, USD
101. vtcpay-phuongdong VTC Pay Channels (Local Bank) Online Banking VND, USD
102. vtcpay-abbank VTC Pay Channels (AB Bank) Online Banking VND, USD
103. vtcpay-lienvietpostbank VTC Pay Channels (Lienviet Bank) Online Banking VND, USD
104. vtcpay-bvb VTC Pay Channels (Baoviet Bank) Online Banking VND, USD
105. NGANLUONG NGANLUONG Indirect Internet Banking and Physical Payment VND, USD
106. NL_VCB_ATM Bank for Foreign Trade of Vietnam (Vietcombank) ATM Online VND, USD
107. NL_VCB_IB Bank for Foreign Trade of Vietnam (Vietcombank) Internet Banking VND, USD
108. NL_DAB_ATM DongA JSC Bank (DongA Bank) ATM Online VND, USD
109. NL_DAB_IB DongA JSC Bank (DongA Bank) Internet Banking VND, USD
110. NL_TCB_ATM The Vietnam Technological and Commercial JSC Bank (Techcombank) ATM Online VND, USD
111. NL_TCB_IB The Vietnam Technological and Commercial JSC Bank (Techcombank) Internet Banking VND, USD
112. NL_MB_ATM Military JSC Bank (MB) ATM Online VND, USD
113. NL_VIB_ATM Vietnam International Bank (VIB) ATM Online VND, USD
114. NL_ICB_ATM Vietnam Joint Stock Commercial Bank for Industry and Trade (VietinBank) ATM Online VND, USD
115. NL_EXB_ATM Vietnam Export Import Commercial Joint Stock Bank (Eximbank) ATM Online VND, USD
116. NL_ACB_ATM Asia Commercial Bank (ACB) ATM Online VND, USD
117. NL_HDB_ATM HoChiMinh City Development Joint Stock Commercial Bank (HDBank) ATM Online VND, USD
118. NL_MSB_ATM Vietnam Maritime Commercial Joint Stock Bank (MaritimeBank) ATM Online VND, USD
119. NL_NVB_ATM Nam Viet Bank (NaviBank) ATM Online VND, USD
120. NL_VAB_ATM Vietnam Asia Commercial Joint Stock Bank (VietA Bank) ATM Online VND, USD
121. NL_VPB_ATM Vietnam Prosperity Bank (VPBank) ATM Online VND, USD
122. NL_SCB_ATM Saigon Thuong Tin Commercial Joint Stock Bank (Sacombank) ATM Online VND, USD
123. NL_GPB_ATM Global Petro Commercial Joint Stock Bank (GPBank) ATM Online VND, USD
124. NL_AGB_ATM Vietnam Bank For Agriculture and Rural Development (Agribank) ATM Online VND, USD
125. NL_BIDV_ATM Bank for Investment & Dof Vietnam (BIDV) ATM Online VND, USD
126. NL_BIDV_IB Bank for Investment & Dof Vietnam (BIDV) Internet Banking VND, USD
127. NL_OJB_ATM Ocean Commercial One Member Limited Liability Bank (OceanBank) ATM Online VND, USD
128. NL_PGB_ATM Petrolimex Group Commercial Joint Stock Bank (PGBank) ATM Online VND, USD
129. NL_SHB_ATM Saigon Hanoi Commercial Joint Stock Bank (SHB) ATM Online VND, USD
130. NL_TPB_ATM Tien Phong Commercial Joint Stock Bank (TienPhongBank) ATM Online VND, USD
131. NL_NAB_ATM Nam A commercial joint stock bank (NamABank) ATM Online VND, USD
132. NL_SGB_ATM Sai Gon Bank for Industry and Trade (Saigon Bank) ATM Online VND, USD
133. Artajasa ATM Transfer via ATM Bersama Physical Payment IDR
134. credit5 Credit Card/ Debit Card Credit Card MYR
135. BAY_IB Bank of Ayudhya (Krungsri) Online Banking THB
136. creditO Credit Card / Debit Card Multi Currency Credit Card AUD, CNY, SGD, THB, USD, MYR

Data attributes for individual MOLPay seamless

Options for individual MOLPay seamless can alternatively be specified through the use of data attributes, as explained above.

Return Parameters

  • All return parameters are same as described in MOLPay API for merchant.
  • Merchant can use the same return URL script for this seamless integration.
  • Once payment done, existing page will be replaced by the merchant return URL.

Support

Merchant Technical Support / Customer Care : [email protected]
Sales/Reseller Enquiry : [email protected]
Marketing Campaign : [email protected]
Channel/Partner Enquiry : [email protected]
Media Contact : [email protected]
R&D and Tech-related Suggestion : [email protected]
Abuse Reporting : [email protected]

⚠️ **GitHub.com Fallback** ⚠️