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

Seamless Integration

Latest update: 2016/09/21

  • Add new Payment Channel:
    • FPX_OCBC
    • FPX_SCB
    • FPX_ABB

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.10/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
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 (Maybank2u, CIMB Clicks, HLB Connect, RHB Now, PBB Online, Bank Islam
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)
19. cash-711 7-Eleven(MOLPay Cash)
20. credit Credit Card/ Debit Card
21. ATMVA ATM Transfer via Permata Bank
22. dragonpay Dragonpay
23. paysbuy PaysBuy
24. Point-BCard Bcard points
25. credit3 Credit Card/ Debit Card
26. NGANLUONG NGANLUONG
27. crossborder Credit Card/ Debit Card
28. paypal PayPal
29. enetsD eNETS
30. UPOP China Union pay
31. alipay Alipay.com
32. polipayment POLi Payment
33. cash-epay e-pay
34. WEBCASH WEBCASH
35. PEXPLUS PEx+
36. jompay JOMPay
37. Cash-Esapay Cash Esapay
38. TH_PB_SCBPN Paysbuy SCBPN
39. TH_PB_KTBPN Paysbuy KTBPN
40. TH_PB_BBLPN Paysbuy BBLPN
41. TH_PB_BAYPN Paysbuy BAYPN
42. TH_PB_CASH Paysbuy CASH
43. FPX_OCBC FPX OCBC Bank
44. FPX_SCB FPX Standard Chartered Bank
45. FPX_ABB FPX Affin Bank Berhad

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