Skip to content

Razer Merchant Services Seamless Integration v2.0.7

Jump to bottom
candyyng edited this page Feb 21, 2020 · 1 revision

Seamless Integration

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: support-sa@razer.com

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/js/MOLPay_seamless.deco.js"></script>

Example

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>

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.

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. | fpx | MyClear FPX (Maybank2u, CIMB Clicks, HLB Connect, RHB Now, PBB Online, Bank Islam | Online Banking
  6. | hlb | Hong Leong Bank(HLB Connect) | Online Banking
  7. | maybank2u | Maybank(Maybank2u) | Online Banking
  8. | pbb | PublicBank (PBB Online) | Online Banking
  9. | rhb | RHB Bank(RHB Now) | Online Banking
  10. | cash-711 | 7-Eleven(MOLPay Cash) | Physical Payment

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 : support-sa@razer.com
Sales/Reseller Enquiry : sales-sa@razer.com
Marketing Campaign : marketing-sa@razer.com
Channel/Partner Enquiry : channel-sa@razer.com
Media Contact : media-sa@razer.com
R&D and Tech-related Suggestion : technical-sa@razer.com
Abuse Reporting : abuse-sa@razer.com

Clone this wiki locally