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

Seamless Integration

Latest update: 2016/11/10

  • Add new Payment Channel (VTC-Pay channels):
    • vtcpay-ewallet
    • vtcpay-bank
    • vtcpay-credit
    • vtcpay-ewalletbank
    • vtcpay-ewalletcredit
    • vtcpay-bankcredit
    • vtcpay-vietcombank
    • vtcpay-techcombank
    • vtcpay-mb
    • vtcpay-vietinbank
    • vtcpay-agribank
    • vtcpay-dongabank
    • vtcpay-oceanbank
    • vtcpay-bidv
    • vtcpay-shb
    • vtcpay-vib
    • vtcpay-maritimebank
    • vtcpay-eximbank
    • vtcpay-acb
    • vtcpay-hdbank
    • vtcpay-namabank
    • vtcpay-saigonbank
    • vtcpay-sacombank
    • vtcpay-vietabank
    • vtcpay-vpbank
    • vtcpay-tienphongbank
    • vtcpay-seaabank
    • vtcpay-pgbank
    • vtcpay-navibank
    • vtcpay-gpbank
    • vtcpay-bacabank
    • vtcpay-phuongdong
    • vtcpay-abbank
    • vtcpay-lienvietpostbank
    • vtcpay-bvb
    • Cash-SAM

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.11/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="".

Nama 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.
mpscash_waittime n[0..48] O Hour before cash payment is expired
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
1. affinonline Affin Bank(Affin Online)
2. amb Am Bank (Am Online)
3. bankislam Bank Islam
4. cimbclicks CIMB Bank(CIMB Clicks)
5. hlb Hong Leong Bank(HLB Connect)
6. maybank2u Maybank(Maybank2u)
7. pbb PublicBank (PBB Online)
8. rhb RHB Bank(RHB Now)
9. fpx MyClear FPX B2C (Maybank2u, CIMB Clicks, HLB Connect, RHB Now, PBB Online, Bank Islam.biz, etc.)
10. fpx_amb FPX Am Bank (Am Online)
11. fpx_bimb FPX Bank Islam
12. fpx_cimbclicks FPX CIMB Bank(CIMB Clicks)
13. fpx_hlb FPX Hong Leong Bank(HLB Connect)
14. fpx_mb2u FPX Maybank(Maybank2u)
15. fpx_pbb FPX PublicBank (PBB Online)
16. fpx_rhb FPX RHB Bank(RHB Now)
17. FPX_OCBC FPX OCBC Bank
18. FPX_SCB FPX Standard Chartered Bank
19. FPX_ABB FPX Affin Bank Berhad
20. FPX_BKRM FPX Bank Kerjasama Rakyat Malaysia Berhad
21. FPX_BMMB FPX Bank Muamalat
22. FPX_KFH FPX Kuwait Finance House
23. FPX_BSN FPX Bank Simpanan Nasional
24. FPX_ABMB FPX Alliance Bank Malaysia Berhad
25. FPX_UOB FPX United Overseas Bank
27. cash-711 7-Eleven(MOLPay Cash)
28. credit Credit Card/ Debit Card
29. ATMVA ATM Transfer via Permata Bank
30. dragonpay Dragonpay
31. paysbuy PaysBuy
32. Point-BCard Bcard points
33. credit3 Credit Card/ Debit Card
34. NGANLUONG NGANLUONG
35. crossborder Credit Card/ Debit Card
36. paypal PayPal
37. enetsD eNETS
38. UPOP China Union pay
39. alipay Alipay.com
40. polipayment POLi Payment
⚠️ **GitHub.com Fallback** ⚠️