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

Seamless Integration

Latest update: 2017/05/16

  • Add new Payment Channel:
    • CIMB-VA

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

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** ⚠️