Repository navigation
RazerMS Inpage Checkout Guide v2.0
adryn33129 edited this page Oct 6, 2023
·
17 revisions
Please do not generate your vcode in JS as this will disclose the merchant verify key.
Register your domain by email to our support : support-sa@razer.com
Include below javascript library in your web. URL depends on serve pointing to.
<!-- URL for jQuery -->
Production : https://pay.merchant.razer.com
Sandbox : https://sandbox.merchant.razer.com
UAT : https://uat.onlinepayment.com.my <!-- jQuery (necessary for RazerMS Seamless JavaScript plugins) -->
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.11.3/jquery.min.js"></script>
<script> var API_HOST = "https://pay.merchant.razer.com"; </script>
<script src="https://pay.merchant.razer.com/RMS/API/seamlessiframe/js/2.0/MOLPay_seamlessiframe.deco.js"></script> <!-- 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>The RazerMS seamless iframe plugin process your button, 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 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 | The receiver name of the shipping address. |
| 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 | Used for multiple return URL. All URLs must be registered beforehand with RazerMS. |
| mpsnotifyurl | ans{1..200} | O | Merchant notification URL endpoint . All URLs must be registered beforehand with RazerMS. |
| mpscallbackurl | ans{1..200} | O | Merchant callback URL endpoint. 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 support-sa@razer.com in advanced before starting using pre-auth payment) |
| mpstokenstatus | n[0/1] | O | To tokenized the transaction. |
| mpstoken | ans | O | To make payment with the card token. |
| mpscustomerid | ans | O | *Mandatory when merchant want to allow the buyer wants to make payment with the card token. |
| mpsccbox | ans | M | Element id or class name to show the iframe. E.g. #MOLPAYCC, .MOLPAYCC. |
| 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 |
| No | Code | Description |
|---|---|---|
| 1. | M | Mandatory field. |
| 2. | O | Optional field, value can be empty. |
| 3. | C | Conditional |
| 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 |
| 2. | CREDITAI | 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 |
| 3. | CRYPTO_TRIPLEA | Cryptocurrency (BTC, ETH & USDT) |
Wallet | USD, MYR, SGD, EUR |
Options for individual RazerMS seamless iframe can alternatively be specified through the use of data attributes, as explained above.
- 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.