Skip to content

RazerMS Inpage Checkout Guide v2.0

adryn33129 edited this page Jun 8, 2021 · 17 revisions

RazerMS Inpage Checkout Guide v2.0

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 RazerMS Seamless JavaScript plugins) -->
 <script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
 <script src="https://www.onlinepayment.com.my/RMS/API/seamlessiframe/js/2.0/MOLPay_seamlessiframe.deco.js"></script> 

Example

<!-- Radio button trigger RazerMS Seamless Iframe -->
<input type="radio" name="payment_options" id="paymentcredit_alb-paymex" value="credit" data-toggle="molpayseamlessiframe" data-mpsmerchantid="MOLPay_seamless_Dev" data-mpschannel="credit" data-mpsamount="1.20" data-mpsorderid="TEST1139669863" data-mpsbill_name="MOLPay Demo" data-mpsccbox="#MOLPAYCC" required />
<!-- Div element for iframe to be loaded -->
<div id="MOLPAYCC"></div>

Usage

The RazerMS seamless iframe plugin process your button, via data attributes.

Via data attributes

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

<input type="radio" data-toggle="molpayseamlessiframe">Pay by Credit/Debit Card</button> 

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/C Description
mpsmerchantid an{1..32} M Merchant login username provided by RazerMS.
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.
mpsbill_add_line1 an{1..200} O The first line of the buyer's address. (If mpsbill_add_line1 present then all mpsbill_* parameter with Conditional need to be present)
mpsbill_add_line2 an{1..200} O The second line of the buyer's address.
mpsbill_zip an{1..10} C The zipcode of the buyer's address.
mpsbill_city an{1..128} C The city of the buyer's address
mpsbill_state an{1..64} C The state of the buyer's address.
mpscountry a{2} C Buyer country.
mpsship_name an{1..128} C Bill / Description provided by merchant / buyer.
mpsship_add_line1 an{1..200} O The first line of the shipping address. (If mpsship_add_line1 present then all mpsbill_* parameter with conditional need to be present)
mpsship_add_line2 an{1..200} O The second line of the shipping address.
mpsship_zip n{1..10} C The zipcode of the shipping address.
mpsship_city an{1..128} C The city of the shipping address.
mpsship_state an{1..64} C The state of the shipping address.
mpsship_country a{2} C The countryof the shipping address.
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.
Valid value : 'en', 'cn', 'encn'
mpsreturnurl ans{1..200} O Obsoleted. Used for multiple return URL. All URLs must be registered beforehand with RazerMS.
non_3ds n[0/1] O Applicable to card processing via specific processor using specific currency for pre-approved partner only.
Equal to 0 by default and 1 for non-3DS transaction
mpstcctype a{4} O SALS
AUTH (For card payment only, please inform [email protected] in advanced before starting using pre-auth payment)
mpstokenstatus n[0/1] O To tokenized the transaction.
mpsccbox ans M Element id or class name to show the iframe. E.g. #MOLPAYCC, .MOLPAYCC.

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 Supported
1. credit Credit Card/ Debit Card Credit Card MY, MYR, CC (TxnType: SALS, AUTH)
2. creditT Credit Card/ Debit Card Credit Card Worldwide, MultiCurrency, CC (TxnType: SALS, AUTH)
AWG, AUD, BSD, BHD, BBD, BYR, BZD, BRL, BIF, CAD, KYD, CNY, HRK, CZK, DKK, DOP, XCD, EUR, GYD, HKD, HUF, INR, ILS, JMD, JPY, KWD, LTL, MYR, MXN, ANG, NZD, NOK, OMR, PLN, GBP, RON, RUB, SAR, RSD, SGD, ZAR, KRW, SRD, SEK, CHF, TWD, TTD, THB, TRY, AED, USD

Data attributes for individual RazerMS seamless iframe

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

Return Parameters

  • All return parameters are the same as described in RazerMS API for merchants.
  • Merchant can use the same return URL script for this seamless iframe integration.
  • Once payment is done, the 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]