API SPECIFICATION FOR MOLPAY INTEGRATION (Version 10.8) Last updated June 6, 2013

Transcription

1 API SPECIFICATION FOR MOLPAY INTEGRATION (Version 10.8) Last updated June 6, 2013 MOLPay Sdn Bhd ( X) B-13-3A, Jalan Multimedia 7/AH, CityPark, i-city, Shah Alam, Selangor Darul Ehsan, Malaysia. +(603) (603) [email protected]

2 Award Winner of : NetBuilder has won MEPS FPX MOST OUTSTANDING MERCHANT 2009 Payment Model Compliance of : 1

3 TABLE OF CONTENTS A. INTRODUCTION BENEFIT ONLINE PAYMENT TRANSACTION FLOW REQUIREMENT OF MERCHANT INTEGRATION... 8 B. PAYMENT CHANNEL ACCEPTED Malaysia Payment Gateway (Credit Card & local debit payment) Union Pay (Debit payment in RMB) Alipay (Largest China Online Payment Service Provider) MOLPay PayPal Express Checkout MOLPay Crossborder Payment MOLPay Physical Payment (Cash payment) C. MERCHANT INTEGRATION Front-end payment page URL for online buyer Variable passing method Default Parameters (required by payment page) Integration example Return parameters (by POST Method) Example of return script

4 D. SECURITY Security Checking i. Vcode ii. Security Key (skey) Security Items i. Verify Key E. PAYMENT STATUS QUERY & NOTIFICATION Payment Status Query (PSQ) i. Indirect PSQ ii. Direct PSQ iii. Daily PSQ iv.refund Query PAYMENT STATUS NOTIFICATION i. Callback Query with Instant Payment Notification (IPN) ii. MOLPay Multiple Return URL F. REFERENCES REF 1 : List of Country names & code REF 2 : PayPal Accepted Currency REF 4 : MOLPay Mobile SDK REF 5 : MOLPay Supported Shopping Cart REF 6 : Logos of all brand name

5 A. INTRODUCTION Dealing with banks and 3rd party payment gateway suppliers are time-consuming and it might cost you a lot of money. We also understand that it s a hassle for those non-technical people to integrate even one kind of online payment method into their existing website. Thus MOLPay Sdn Bhd proudly presents MOLPay Secure Online Transaction service to cater your requirement. MOLPay is a service to help merchant to sell online. The service includes a : front-end page (for online buyer to enter their credit card information) back-end merchant site (for merchant to track their client payment status) FQDN: (using HTTPs) This is the URL for starting and ending point of payment process. This domain has been verified and secured by a high-grade 256-bit encryption SSL. General information about this service could be found here: OR 1. Benefit Lowest transaction rate (or discounted rate) that charged by bank Support variety of online payment method in Malaysia Easy to integrate or no integration required if using NetBuilder EC package Support well-known online shopping cart system Save time and money to have all payment channels in a box High-grade security assurance NOTE : Fraud Scan will not be activated under a testing account or any nontraditional credit card payment and always return the value, or so called Fraud Score of -1 or - or n/a for the fraud score. Back-end admin site for merchant: URL Requirement Merchant ID & Password are required to logon * Main function Allow merchant to check : i. Merchant profile, change Password and configure return URL & callback URL. ii. Transaction listing and details. iii. Settlement listing and details. iv. Transaction reports. * Both MERCHANT ID and PASSWORD are CASE SENSITIVE 4

6 2. Online Payment Transaction Flow Below are the steps for merchant to start accepting payment online via MOLPay payment gateway. i. Merchant have to integrate their online store and passing all the required parameters to MOLPay. ii. Now, buyer can start to make their order online on merchant s website and choose MOLPay Payment option to checkout. iii. iv. Buyer will be redirected to MOLPay Payment page to confirm the information passing from merchant website on step (i). At this stage, if necessary, buyer still able to modify some of the information passing before and choose any payment option available on MOLPay payment page. For Credit card payment, buyer need to key in their Credit card information in order to proceed. v. For non-credit card payment, when reach the bank site, buyer need to key in their username and password for their internet banking account to proceed. vi. Buyer has to confirm the payment at bank site and wait for bank to process the payment. vii. viii. Bank will return back the payment status to MOLPay to notify that is captured or failure transaction. At this stage, payment notification will be send to buyer and merchant accordingly. MOLPay then will notified merchant s website the status of the payment through merchant s return URL and merchant need to update the order status of the buyer accordingly. 5

7 6

8 7

9 3. Requirement of Merchant Integration Kindly refer below for the requirement before merchant can start to do the integration with MOLPay Payment Gateway. i. Merchant online store (If any). ii. iii. iv. MOLPay Merchant ID and Verify Key compulsory before you can start accept payment online via MOLPay Payment Gateway. Merchant Return URL compulsory to allow MOLPay notified payment status to merchant s system/online store. Merchant Callback URL compulsory to allow merchant to receive any updated of payment status after a while the payment has been done. v. Any technical person in charge to handle the integration process from beginning to the end. 8

10 B. PAYMENT CHANNEL ACCEPTED 1. Malaysia Payment Gateway (Credit Card & local debit payment) This channel covers most of all payment processor in Malaysia. Accept payments via : i. Credit Card Visa & MasterCard ii. Internet funds transfer Maybank2u, MEPS FPX, CIMB Clicks, RHB Online, Hong Leong Online, MEPSCash etc. 2. Union Pay (Debit payment in RMB) * This is a foreign currency payment channel and the currency in actual transaction is China Renminbi (RMB/CNY) This channel is now connecting to more than 20 China local banks directly and supporting more than 40 debit cards. Covers more than 98% of your target customers in mainland China. 3. Alipay (Largest China Online Payment Service Provider) * Alipay is committed to providing payment services with simple, secure and speedy solutions to China s e-business. Through their strategic cooperation with domestic commercial bank, merchants have gained access to a broad online consumer market in mainland China. All payment under this channel will be converted to USD and recorded into MOLPay database once submitted to Alipay payment gateway. At Alipay, USD amount will then be converted and transacted in RMB. Refer Figure B-3-i below to understand the currency flow of Alipay channel on MOLPay : 9

11 (1) (2) MYR USD (4) (3) RMB Figure B-3-i Details : 1) Merchant sends or stores amount in MYR. 2) MOLPay will convert amount from MYR to USD. 3) Alipay converts amount in USD to RMB. 4) When return to MOLPay, it will return MYR to merchant store. 4. MOLPay PayPal Express Checkout * Suitable for merchant to well managed their online business transaction secure and safely. Accept multiple currencies to make a payment. May refer to a list of PayPal accepted currencies (REF 2) to view the list of currency code available for this channel. Below are the steps to activate: i. Sign up for PayPal account. ii. Grant 3 rd party API access. iii. Configure PayPal on MOLPay merchant account. iv. Integrate your website with MOLPay. Merchant may refer Figure B-4-i below for the steps to activate PayPal on MOLPay. 10

12 Figure B-4-i 11

13 5. MOLPay Crossborder Payment * Transaction will be transacted in currency other than Ringgit Malaysia (MYR). Support various type of currencies and allow merchant to accept payment worldwide. No auto-forex conversion occurs on this channel as this is platform for multi-currency payment. 6. MOLPay Physical Payment (Cash payment) * MOLPay is the first multi-currency payment gateway in Southeast Asia that accepts cash payments for online purchases, through physical outlets such as convenience stores and bookstores. With MOLPay Physical Payment Solution, your customers can now buy products from your online store and pay at over 3,000 physical outlets across Malaysia, Brunei and Singapore (to be added soon). When the customer pays at the payment outlets, merchant will receive a payment notification and can proceed to deliver the products to your customer. IMPORTANT NOTICE (*) Refer to payment channel option for selective subscriber only. 12

14 C. MERCHANT INTEGRATION Below are the basic steps for merchant to integrate their online store/website with MOLPay Payment Gateway: Must have online store, website, blog, any online medium for them to sell online. Merchant need to request MOLPay sandbox account for this process. You may contact our sales representative for this arrangement. Start to integrate their online store above using parameters required by MOLPay. Perform the UAT/SIT to ensure each payment & system flow is on the right track. Once everything is done, merchant can start to sign up for real MOLPay account. Done. Below are the reference that merchant can follow to start the integration. 1. Front-end payment page URL for online buyer. MerchantID o Compulsory. o Is the merchant login name given by MOLPay. Payment_Method o Optional o Is the identity for the gateway which will process your payment information which has been send to MOLPay. o Please refer to table below for reference. Channel Visa & Mastercard (default) Mobile Money Ezeelink Maybank2u Fund Transfer MEPS FPX CIMB Clicks RHB Online Am Online Hong Leong Bank Online Filename Credit Payment index.php mobilemoney.php ezeelink.php Debit Payment maybank2u.php fpx.php cimb.php rhb.php amb.php hlb.php 13

15 Mepscash Online mepscash.php Webcash Online webcash.php Physical Payment (Cash payment) Esapay (Malaysia) esapay.php 7-Eleven (Malaysia) Coming Soon Senheng/SenQ (Malaysia) senheng.php Singpost SAM (Singapore) singpost.php Crossborder Payment PayPal paypal.php Dragonpay dragonpay.php 14

16 2. Variable passing method. POST/GET : to front-end URL. POST : to return URL (filled by merchant after logon to Admin site or passing by merchant during the integration) 3. Default Parameters (required by payment page). Variable Name amount Format Floating point Description The transaction amount in one bill. Configurable to lock this field. Min accepted amount : 1.01 orderid Alpha-numeric Bill/invoice number. Configurable to lock this field. bill_name Alpha-numeric Buyer name - UTF-8 encoding is recommended for Chinese content bill_ Alpha-numeric Buyer bill_mobile Alpha-numeric Buyer mobile contact number. bill_desc Alpha-numeric Description of the bill. country 2 Uppercase character Destination (Country) that the goods to be shipped or delivered or the buyer country. 2 letter ISO-3166 country code. returnurl vcode cur langcode URL address MD5 Encrypted String 3 Lowercase character 2 Lowercase character * Please refer REF 1 below for more info This URL will be used if merchant intend to use their merchant account for multiple online shops/websites. - UTF-8 encoding is recommended for Chinese content * Please refer Section E-2-ii below for more info Additional security code to avoid any changes on any value pass to MOLPay e.g : md5($amount.$merchantid.$orderid.$verifykey) * Kindly refer Section D-1-i below for more info Different payment channel will have different requirement of currency. Merchant may refer to Additional currency info below for the details. Merchant may switch the language display on their payment page by passing the language code to MOLPay during the integration. Supported language as below : Code Language en English (default) cn Simplified Chinese 15

17 Additional Currency Info Payment Type 1. Malaysia Payment Gateway (Credit Card & local debit payment) 2. Union Pay (Debit payment in RMB) Description - All transaction are in Ringgit Malaysia (MYR) only. - Accepted currencies for Auto-forex conversion are US Dollar (USD), New Taiwan Dollar (NTD/TWD). - The forex rate is based on MOLPay preferential rate and will be update without prior notice. - Auto-forex conversion is NOT recommended for those merchants who cannot take the risk of fluctuation in forex rate. Optional accepted values : rm/myr usd ntd/twd - All transactions are in Chinese Renminbi (RMB/CNY) only. - Accepted currencies for auto-forex conversion are Malaysian Ringgit (RM/MYR). - The forex rate is based on MOLPay preferential rate and will be update without prior notice. - Auto-forex conversion is NOT recommended for those merchants who cannot take the risk of fluctuation in forex rate. Optional accepted values: rm/myr rmb/cny 3. Alipay - Accepted currencies for auto-forex conversion are US dollar (USD), New Taiwan Dollar(TWD/NTD) - The forex rate is based on MOLPay preferential rate and will be update without prior notice. - Auto-forex conversion is NOT recommended for those merchants who cannot take the risk of fluctuation in forex rate. 4. MOLPay PayPal Express Checkout Optional accepted values: rm/myr ntd/twd usd May refer to REF 2 in Reference section. 16

18 5. MOLPay Crossborder Payment 6. MOLPay Physical Payment (Cash payment) Currently only PHP currency accepted for this payment method. Optional accepted values at the moment are : - rm/myr : Senheng, Esapay - sgd : Singpost/SAM 17

19 4. Integration example Merchant may refer below for the sample of integration code to MOLPay payment gateway. Via GET method (Simple HTML hyperlink All the below in one line) i. For PHP developer <?PHP echo <a?> href= ; echo amount=.$amount. & ; echo orderid=.urlencode($oid). & ; echo bill_name=.urlencode($name). & ; echo bill_ =.urlencode($ ). & ; echo bill_mobile=.urlencode($mobile). & ; echo bill_desc=.urlencode($description). & ; echo country=.$country. & ; echo returnurl=.urlencode($returnurl). & ; echo vcode=.$vcode. & ; echo cur=.$cur. & ; echo langcode=.$langcode. > Pay via MOLPay Here </a> ; 18

20 ii. For ASP/ASP.NET developer <% dim amount, orderid, name, , mobile, desc, cur, country, langcode amount = ordered = DG873 name = Mr Albert Lim = [email protected] mobile = desc = DIGI Reload Coupon RM30 cur = rm country = MY returnurl = langcode = en vcode = md5(amount & merchantid & orderid & xxxxxxxx ) // REPLACE xxxxxxxx with MOLPay Verify Key %> response.write("<a href= response.write("amount= & amount) response.write("&orderid= & orderid) response.write("&bill_name= & name) response.write("&bill_ = & ) response.write("&bill_mobile= & mobile) response.write("&bill_desc= & desc) response.write("&country= & country) response.write("&returnurl= & returnurl) response.write("&vcode= & vcode) response.write("&cur= & cur) response.write("&langcode= & langcode) response.write(" > Pay via MOLPay Here </a> ) 19

21 Via POST method (Simple HTML Form) i. For PHP developer <?PHP echo <form?> action= method=post > ; echo <input type=hidden name=amount value=$amount> ; echo <input type=hidden name=orderid value=$oid> ; echo <input type=hidden name=bill_name value=$name> ; echo <input type=hidden name=bill_ value=$ > ; echo <input type=hidden name=bill_mobile value=$mobile>; echo <input type=hidden name=bill_desc value=$description> ; echo <input type=hidden name=country value=$country> ; echo <input type=hidden name=returnurl value=$returnurl> ; echo <input type=hidden name=vcode value=$vcode> ; echo <input type=hidden name=cur value=$cur> ; echo <input type=hidden name=langcode value=$langcode> ; echo <input type=submit echo </form> ; value= PAY HERE > ; 20

22 ii. For ASP/ASP.NET developer <% dim amount, orderid, name, , mobile, desc, cur, country, langcode amount = ordered = DG873 name = Mr Albert Lim = [email protected] mobile = desc = DIGI Reload Coupon RM30 cur = rm country = MY returnurl = langcode = en vcode = md5(amount & merchantid & orderid & xxxxxxxx ) // REPLACE xxxxxxxx with MOLPay Verify Key response.write( <form action= method=post >) response.write( <input type=hidden name=amount value= &amount& >) response.write( <input type=hidden name=orderid value= &oid& >) response.write( <input type=hidden name=bill_name value= &name& >) response.write( <input type=hidden name=bill_ value= & & >) response.write( <input type=hidden name=bill_mobile value= &mobile& >) response.write( <input type=hidden name=bill_desc value= &desc& >) response.write( <input type=hidden name=country value= &country& >) response.write( <input type=hidden name=returnurl value= &returnurl& >) response.write( <input type=hidden name=vcode value= &vcode& >) response.write( <input type=hidden name=cur value= &cur& >) response.write( <input type=hidden name=langcode value= &langcode& >) response.write( <input type=submit value= PAY HERE >) response.write( </form> ) %> 21

23 5. Return parameters (by POST Method) Variable Name Format Attribute Description amount (*) Floating-point The transaction amount in one bill. orderid Alpha-numeric The bill/invoice number. appcode (*) Alpha-numeric Bank approval code. tranid Integer Transaction ID for tracking purpose domain Alpha-numeric Merchant ID status Numeric 00, 11 or 22 (**) error_code (*) error_desc (*) currency paydate channel Alpha-numeric Alpha-numeric Alpha-numeric Date/Time Character YYYY-MM-DD HH:mm:ss skey (*) Alpha-numeric MD5 encryption Status of transaction: 00 - success 11 - failure 22 pending (**) Error code for failure transaction (if any). Error description for failure transaction (if any). Depends on payment channel. Date time of the transaction. Depends to the payment method. Please refer Return Channel Reference below for more info. Encrypted string to verify whether the transaction is from a valid source. Verify Key is required. (*) For failure transaction under test account, there s no value return for this field. (**) Applied for FPX transaction only and will be return to merchant s timeout URL once merchant activated FPX Asynchronous Payment feature in merchant profile (Please refer REF 3 for further details) 22

24 Return Channel Reference Channel Payment Method Currency Return Credit Payment Visa & Mastercard (default) Credit RM Mobile Money MM-Weblink RM Ezeelink MM-Ezeelink RM Debit Payment Maybank2u Fund Transfer MB2u RM MEPS FPX FPX RM CIMB Clicks CIMB-Clicks RM RHB Online RHB-ONL RM Am Online AMB-W2W RM Hong Leong Bank Online HLB-ONL RM Mepscash Online MEPSCash RM Webcash WEBCASH RM Physical Payment (Cash Payment) Esapay Cash-Esapay RM Crossborder Payment China Union Pay PM-ASIA Depends on currency code passing during the payment. PayPal PayPal Depends on currency code return by PayPal Dragonpay dragonpay PHP 23

25 6. Example of return script IMPORTANT NOTICE Multiple md5 encryption is used to verify the secret key (skey) to avoid faked transaction from 3rd party when post the return status from MOLPay to Merchant website. Please keep the Verify Key and encryption method as a secret to protect your Ecommerce website. Below is the sample of the return script for merchant to refer. <?php For PHP Developer $vkey ="xxxxxx"; //Replace xxxxxxxx with your MOLPay Verify Key /******************************** *Don't change below parameters ********************************/ $tranid = $_POST['tranID']; $orderid = $_POST['orderid']; $status = $_POST['status']; $domain = $_POST['domain']; $amount = $_POST['amount']; $currency = $_POST['currency']; $appcode = $_POST['appcode']; $paydate = $_POST['paydate']; $skey = $_POST['skey']; /*********************************************************** * All undeclared variables below are coming from POST method ************************************************************/ $key0 = md5( $tranid.$orderid.$status.$domain.$amount.$currency ); $key1 = md5( $paydate.$domain.$key0.$appcode.$vkey ); if( $skey!= $key1 ) $status= -1; // Invalid transaction if ( $status == "00" ) { if ( check_cart_amt($orderid, $amount) ) { /*** NOTE : this is a user-defined function which should be prepared by merchant ***/ // action to change cart status or to accept order // you can also do further checking on the paydate as well // write your script here... } } else { // failure action // write your script here... }?> 24

26 For ASP/ASP.NET Developer <!--#include file="md5.asp"--> For ASP Developer <!--#include file="md5.aspx"--> For ASP.NET Developer <% md5.asp/md5.aspx is a 3rd party developed md5 solution for ASP/ASP.NET user You could get the md5.asp/md5.aspx from MOLPay support team ' Some variables below are coming from POST method dim key0, key1, tranid, orderid, status, domain, amount, currency, paydate, appcode, skey tranid = Request.Form( tranid ) orderid = Request.Form( orderid ) status = Request.Form( status ) domain = Request.Form( domain ) amount = Request.Form( amount ) currency = Request.Form( currency ) paydate = Request.Form( paydate ) appcode = Request.Form( appcode ) skey = Request.Form( skey ) key0 = md5( tranid & orderid & status & domain & amount & currency ) key1 = md5( paydate & domain & key0 & appcode & xxxxxx ) Replace xxxxxxxx with your MOLPay Verify Key invalid transaction if the key is different If skey <> key1 then End if status= -1 If status = "00" then checking the validity of cart amount & orderid. if the verification test passed then can update the order status to paid. you can also do further checking on the paydate as well Else failure action End if %> 25

27 7. Testing account MOLPay DOES NOT provide any testing account for other payment method except for Malaysia Payment Gateway (Credit Card payment: Visa & Mastercard only). Merchant needs to register own Internet Banking Account to do the testing for other payment method. For Credit Card testing payment, it only verifies VISA and MasterCard number validity and NO actual transaction occurs between bank or payment gateway. Visa and Mastercard card number for testing as below : Pattern Mastercard Visa Positive Test Negative Test

28 D. SECURITY 1. Security Checking MOLPay have implemented two security checking in order to protect payment information from being abused by any other unauthorized parties during the payment. i. Vcode MOLPay vcode can be defined as an encrypted security code generated by merchant used to verify a transaction on merchant s payment page. Besides that, the purpose of the vcode is to prevent any changes occur to the payment info and to authorize the validity of the payment sources. It is compulsory for each requested transaction after Enable Verify Payment setting has been activated in merchant profile (Figure D-i-i). Figure D-i-i Vcode was encrypted using MD5 encryption hash function and consist of the following information (must be set in the following orders) : Transaction amount MOLPay Merchant ID Order number MOLPay Verify key How to generate vcode? Vcode = md5( amount & merchantid & order number & verify key) 27

29 Example to generate vcode for PHP developer. <?php $amount = ; $merchantid = ACME ; $orderid = OD8842 ; $verifykey = xxxxxxxx ; // Replace xxxxxxxx with your MOLPay Verify Key // vcode formula $vcode = md5( $amount.$merchantid.$orderid.$verifykey ); // output of the vcode based on above information equals to : $vcode = ec7f2c6e a5e9b75893ee6bc1 ;?> To ensure the vcode generated was correct, merchant may visit the following link for checking. URL : What happen if merchant wrongly generated vcode? An error will be displayed on Merchant's secure payment page as below (Figure D-i-ii) : Figure D-i-ii 28

30 ii. Security Key (skey) MOLPay skey is a security key defined by MOLPay to avoid faked transaction from 3 rd party when MOLPay return the payment status which has been processed to merchant online store. The combination of parameters and MOLPay verify key then will be encrypted using MD5 encryption to generate the security key and give protection to merchant E-commerce website. Merchant MUST implement a checking in between security key return by MOLPay (skey) with security key generated on merchant s E- commerce system (key1) before released/approved any order made from the buyer. Example to generate security key and perform checking before approved order for PHP developer. <?php $vkey ="xxxxxx"; //Replace xxxxxxxx with your MOLPay Verify Key /******************************** *Don't change below parameters ********************************/ $tranid = $_POST['tranID']; $orderid = $_POST['orderid']; $status = $_POST['status']; $domain = $_POST['domain']; $amount = $_POST['amount']; $currency = $_POST['currency']; $appcode = $_POST['appcode']; $paydate = $_POST['paydate']; $skey = $_POST['skey']; //Security key return by MOLPay /*********************************************************** * All undeclared variables below are coming from POST method ************************************************************/ $key0 = md5( $tranid.$orderid.$status.$domain.$amount.$currency ); $key1 = md5( $paydate.$domain.$key0.$appcode.$vkey ); //key1 : Security key generated on Merchant system if( $skey == $key1 ) // If matched, perform another extra checking before approved order elseif( $skey!= $key1 ) // If unmatched, reject the order?> 29

31 2. Security Items i. Verify Key MOLPay Verify Key is uniquely encrypted string owned by all MOLPay merchants. The purpose of it is to provide more secure transaction for each transaction that going through with MOLPay. MOLPay use the Verify Key for various type of function such as: To integrate MOLPay Online Payment with Merchant Website, to verify MOLPay payment, to do checking with the transaction made on MOLPay, etc. How to get the verify key? Logon to MOLPay Merchant Admin site. Go to Merchant Profile tab. Scroll down until you see the word Verify Key Get the value and use it on any functions that require it. Kindly refer figure below. xxxxxx Is the Verify Key provided by MOLPay to Merchant 30

32 E. PAYMENT STATUS QUERY & NOTIFICATION 1. Payment Status Query (PSQ) Payment status query are merchant initiated process, which means query sent from merchant s system to MOLPay to get the updated payment status of any transaction either it has complete the payment loop (returned to merchant site) or not. IMPORTANT NOTICE 1. Merchant is only allowed to QUERY ONCE FOR EVERY 5 MINUTES or the system will block merchant s IP/query source automatically. 2. Kindly be informed that this feature is not available for MOLPay Test account. There have several types of PSQ available: i. Indirect PSQ (Normal PSQ) ii. Direct PSQ (Bank status query) iii. Daily Query iv. Refund Query i. Indirect PSQ (Normal PSQ) i.i TYPE A : PSQ using Single Transaction ID Input : One MOLPay Transaction ID(unique) required to query the transaction status from MOLPay. Output : MOLPay will return single result based on transaction ID given. Front-end URL : Parameter passing method : POST or GET 31

33 Parameters : TYPE A : PSQ USING SINGLE TRANSACTION ID Variable Name Format Description amount Floating point The transaction amount in one bill. Min accepted amount : 1.01 txid Integer Unique MOLPay Transaction ID domain MOLPay Merchant ID Method for merchant to receive response data : type url skey Integer URL Address Alphanumeric Alphanumeric Code Definition 0 In Plain text (default) 1 By POST URL to receive response data from MOLPay. Data will be returned to merchant s system via background (doesn t required browser) Security hash key. Verify key is required. Integration example (for PHP developer) : <?php $skey = md5($txid. $domain. xxxxxxx. $amount); //Replace xxxxxxxx with your MOLPay Verify Key /***************** HTML Format ******************/ echo <a href= ID=12345&domain=shopA&skey=.$skey. > Update Payment for tranid </a> ;?> Return data : Plain text with new line character (type=0) StatCode: 00 StatName: captured TranID: Amount: Domain: shopa VrfKey: 456cf69e5bddfe8ed POST (type=1) $_POST[StatCode] = 00 ; $_POST [StatName] = captured ; $_POST [TranID] = ; $_POST [Amount] = ; $_POST [Domain] = shopa ; $_POST[VrfKey:]= 456cf69e5bddfe8ed ; 32

34 Variable Name Format Description StatCode 2-digit numeric Code Status 00 Success 11 Failure 22 Pending StatName Alphabet Code Success Failure Pending Status captured, settled, ReqCancel, ReqChargeback, authorized failed, cancelled, chargeback, release, reject, blocked Pending, Unknown, TestOK VrfKey TranID Integer MOLPay Transaction ID Amount Floating point Transaction amount in one bill Domain Alphanumeric MOLPay Merchant ID MD5 Encrypted string to verify whether the transaction is from valid source. Verify Key is required. Alphanumeric Was encrypted as (without symbol & ) : md5(amount & xxx & Domain & TranID & StatCode) Replace xxx with MOLPay Verify Key 33

35 i.ii TYPE B : PSQ using Single Order ID (Single output) Input : One order ID (might be not unique) required to query the transaction status from MOLPay. Output : MOLPay will return latest single result based on order ID given. Front-end URL : Parameter passing method : POST or GET Parameters : TYPE B : PSQ USING SINGLE ORDER ID Variable Name amount oid domain Format Floating point Description The transaction amount in one bill. Min accepted amount : 1.01 Order ID of the transaction. MOLPay Merchant ID Method for merchant to receive response data : type url skey Integer URL Address Alphanumeric Alphanumeric Alphanumeric Code Definition 0 In Plain text (default) 1 By POST URL to receive response data from MOLPay. Data will be returned to merchant s system via background (doesn t required browser) Security hash key. Verify key is required. 34

36 <?php Integration example : $skey = md5($oid. $domain. xxxxxxx. $amount); $skey = md5($oid. $domain. xxxxxxx. $amount); //Replace xxxxxxxx with your MOLPay Verify Key /***************** HTML Format ******************/ echo <a href= D=12345&domain=shopA&skey=.$skey. > Update Payment for Order ID </a> ;?> Return data : Plain text with new line character (type=0) StatCode: 00 StatName: captured OrderID : OD Amount : TranID: Amount: Domain: shopa BillingName : James Blunt VrfKey: 456cf69e5bddfe8ed POST (type=1) $_POST[StatCode]= 00 ; $_POST[StatName]= captured ; $_POST[OrderID] = OD ; $_POST[Amount] = ; $_POST[TranID]= ; $_POST[Amount]= ; $_POST[Domain]= shopa ; $_POST[BillingName] = James Blunt ; $_POST[VrfKey]= 456cf69e5bddfe8ed ; Variable Name Format Description StatCode 2-digit numeric Code Status 00 Success 11 Failure 22 Pending StatName Alphabet Code Success Failure Pending Status captured, settled, ReqCancel, ReqChargeback, authorized failed, cancelled, chargeback, release, reject, blocked Pending, Unknown, TestOK Domain OrderID Alphanumeric Order ID for that particular transaction. Amount Floating point Transaction amount in one bill Alphanumeric MOLPay Merchant ID 35

37 BillingName VrfKey Alphanumeric Alphanumeric Name use to make a transaction MD5 encrypted string to verify whether the transaction is from valid source. Verify Key is required. Was encrypted as : md5(amount & xxx & Domain & OrderID & StatCode) Replace xxx with MOLPay Verify Key 36

38 i.iii TYPE C : PSQ using Single Order ID (Batch output) Input : One order ID (might be not unique) required to query the transaction status from MOLPay. Output : MOLPay will return group of transaction result which belongs to order ID given. Front-end URL : Parameter passing method : POST or GET Parameters : TYPE C : PSQ USING SINGLE ORDER ID (BATCH OUTPUT) Variable Name oid domain Format Order ID of the transaction. MOLPay Merchant ID Description Method for merchant to receive response data : type url format skey Integer URL Address Integer Alphanumeric Alphanumeric Alphanumeric Code Definition 0 In Plain text (default) 1 By POST URL to receive response data from MOLPay. Data will be returned to merchant s system via background (doesn t required browser) Code Type 0 Text (each data will be combined by character) 1 Array Security hash key. Verify key is required. 37

39 <?php Integration example : $skey = md5($oid. $domain. xxxxxxx ); //Replace xxxxxxxx with your MOLPay Verify Key /***************** HTML Format ******************/ echo <a href= D=12345&domain=shopA&skey=.$skey. > Update Payment for Order ID </a> ;?> Return data : Plain text : each transaction is separated by newline character (\n) and each field is delimited by TAB (\t) character. (type=0) TranID BillingDate StatCode StatName Amount BillingName pending Lenka captured Mika captured Ciara POST : Return data in text. Info for each transaction will be separated by character. (type=1, format=0) $_POST[TranID] = ; $_POST[BillingDate] = ; $_POST[StatCode] = ; $_POST[StatName] = pending captured captured ; $_POST[Amount] = ; $_POST[BillingName] = Lenka Mika Ciara ; POST : Return data in Array ($_POST[Index][Field]) (type=1, format=1) $_POST[0][TranID] = ; $_POST[0][BillingDate] = ; $_POST[0][StatCode] = 22 ; $_POST[0][StatName] = pending ; $_POST[0] [Amount] = ; $_POST[0] [BillingName] = Lenka ; $_POST[1] [TranID] = ; $_POST[1] [BillingDate] = ; $_POST[1] [StatCode] = 00 ; $_POST[1] [StatName] = captured ; $_POST[1] [Amount] = ; $_POST[1] [BillingName] = Mika ; 38

40 Variable Name Format Description TranID BillingDate StatCode Alphanumeric YYYY-MM- DD 2-digit numeric MOLPay unique Transaction ID Date & time of the transaction Code Status 00 Success 11 Failure 22 Pending StatName Alphabet Code Success Failure Pending Status captured, settled, ReqCancel, ReqChargeback, authorized failed, cancelled, chargeback, release, reject, blocked Pending, Unknown, TestOK OrderID Alphanumeric Order ID for that particular transaction. Amount Floating point Transaction amount in one bill BillingName Alphanumeric Name use to make a transaction 39

41 i.iv TYPE D : PSQ using Multiple Order ID Input : Multiple order ID (might be not unique) required to query the transaction status from MOLPay. Variable Name oids Output : MOLPay will return group of transaction result based on order ID given. Front-end URL : Parameter passing method : POST or GET Parameters : TYPE D : PSQ USING MULTIPLE ORDER ID Format Description Combination of Order ID to request the transaction status. Must be URL encoded. Max number of Order ID = 100 MOLPay Merchant ID Alphanumeric domain Alphanumeric delimiter Alphabet Symbol used to separate the combination of Order ID. Make sure symbol you re using is not apart of the Order ID. You re not allowed to use below symbol as you delimiter. Unauthorized symbol : ", %, *, <, >,?, \, $, &, = Default value = (Merchant may change the delimiter accordingly) type Integer Method for merchant to receive response data. Code Definition 0 In Plain text (default) 1 By POST url URL Address URL to receive response data from MOLPay. Compulsory if value of type=1 Data will be returned to merchant s system via background (doesn t required browser) 40

42 format Integer Code Type 0 Text (each data will be combined by character) 1 Array skey Alphanumeric Security hash key. Verify key is required. Integration example : <?php $skey = md5($domain. $oids. xxxxxxx ); //Replace xxxxxxxx with your MOLPay Verify Key /***************** HTML Format ******************/ echo <form method=post action=' <input type=text name= oids value='23734%7c63872%7c8a8b3%7c1ab31%7c08b23'> <input type=text name= domain value=shopa> <input type=text name= delimiter value=' '> <input type=text name= skey value='fc424f491db75e81a264af9080a18dde'> <input type=submit value='query Payment Status'> </form> ;?> Return data : Plain text : each transaction is separated by newline character (\n) and each field is delimited by TAB (\t) character. (type=0) OrderID TranID BillingDate StatCode StatName Amount BillingName VrfKey pending Lenka sf98sd8fs9dfs9d captured Mika tryrty9rt9y8t9yt95 8a8b captured Ciara zxc9zxc0xczdsd4 POST : Return data in text. Info for each transaction will be separated by character. (type=1, format=0) $_POST[OrderID] = a8b3 ; $_POST[TranID] = ; $_POST[BillingDate] = ; $_POST[StatCode] = ; $_POST[StatName] = pending captured captured ; $_POST[Amount] = ; $_POST[BillingName] = Lenka Mika Ciara ; $_POST[VrfKey] = sf98sd8fs9dfs9d tryrty9rt9y8t9yt95 zxc9zxc0xczdsd4 ; 41

43 POST : Return data in Array ($_POST[OrderID][Field]) (type=1, format=1) $_POST[23734] [TranID] = ; $_POST[23734] [BillingDate] = ; $_POST[23734] [StatCode] = 22 ; $_POST[23734] [StatName] = pending ; $_POST[23734] [Amount] = ; $_POST[23734] [BillingName] = Lenka ; $_POST[23734] [VrfKey] = sf98sd8fs9dfs9d ; $_POST[63872] [TranID] = ; $_POST[63872] [BillingDate] = ; $_POST[63872] [StatCode] = 00 ; $_POST[63872] [StatName] = captured ; $_POST[63872] [Amount] = ; $_POST[63872] [BillingName] = Mika ; $_POST[63872] [VrfKey] = tryrty9rt9y8t9yt95 ; Variable Name Format Description OrderID TranID BillingDate Alpha- Numeric Alphanumeric YYYY-MM- DD Order ID for that particular transaction. MOLPay unique transaction ID Date & time of the transaction StatCode 2-digit numeric Code Status 00 Success 11 Failure 22 Pending StatName Alphabet Code Success Failure Pending Status captured, settled, ReqCancel, ReqChargeback, authorized failed, cancelled, chargeback, release, reject, blocked Pending, Unknown, TestOK VrfKey Amount Floating point Transaction amount in one bill Domain Alphanumeric MOLPay Merchant ID BillingName Alphanumeric Name use to make a transaction Alphanumeric MD5 encrypted string to verify whether the transaction is from valid source. Verify Key is required. Was encrypted as : md5(amount & xxx & Domain & OrderID & StatCode) 42

44 Replace xxx with MOLPay Verify Key 43

45 i.v TYPE E : PSQ using Multiple Transaction ID Input : Multiple transaction ID (each transaction ID must be unique) required to query the transaction status from MOLPay. Variable Name tids Output : MOLPay will return group of transaction result based on transaction ID given. Front-end URL : Parameter passing method : POST or GET Parameters : TYPE D : PSQ USING MULTIPLE TRANSACTION ID Format Description Combination of Transaction ID to request the transaction status. Each transaction ID MUST BE separated by Must be URL encoded. Max number of Transaction ID = 100 MOLPay Merchant ID Code Definition 0 In Plain text (default) 1 By POST url URL Address URL to receive response data from MOLPay. Compulsory if value of type=1 Data will be returned to merchant s system via background (doesn t required browser) format Integer Code Type 0 Text (each data will be combined by character) 1 Array skey Alphanumeric domain Alphanumeric type Integer Method for merchant to receive response data. Alphanumeric Security hash key. Verify key is required. 44

46 <?php Integration example : $skey = md5($domain. $tids. xxxxxxx ); //Replace xxxxxxxx with your MOLPay Verify Key /***************** HTML Format ******************/ echo <form method=post action=' <input type=text name= tids value='23734%7c63872%7c8a8b3%7c1ab31%7c08b23'> <input type=text name= domain value=shopa> <input type=text name= skey value='fc424f491db75e81a264af9080a18dde'> <input type=submit value='query Payment Status'> </form> ;?> 45

47 Return data : Plain text : each transaction is separated by newline character (\n) and each field is delimited by TAB (\t) character. (type=0) TranID BillingDate StatCode StatName Amount BillingName VrfKey pending Lenka sf98sd8fs9dfs9d captured Mika tryrty9rt9y8t9yt captured Ciara zxc9zxc0xczdsd4 POST : Return data in text. Info for each transaction will be separated by character. (type=1, format=0) $_POST[TranID] = ; $_POST[BillingDate] = ; $_POST[StatCode] = ; $_POST[StatName] = pending captured captured ; $_POST[Amount] = ; $_POST[BillingName] = Lenka Mika Ciara ; $_POST[VrfKey] = sf98sd8fs9dfs9d tryrty9rt9y8t9yt95 zxc9zxc0xczdsd4 ; POST : Return data in Array ($_POST[TranID][Field]) (type=1, format=1) $_POST[418607] [BillingDate] = ; $_POST[418607] [StatCode] = 22 ; $_POST[418607] [StatName] = pending ; $_POST[418607] [Amount] = ; $_POST[418607] [BillingName] = Lenka ; $_POST[418607] [VrfKey] = sad8asd9aas9da ; $_POST[418603] [BillingDate] = ; $_POST[418603] [StatCode] = 00 ; $_POST[418603] [StatName] = captured ; $_POST[418603] [Amount] = ; $_POST[418603] [BillingName] = Mika ; $_POST[418607] [VrfKey] = rr21rt54yrtydgsdg ; Variable Name Format Description TranID BillingDate Alphanumeric YYYY-MM- DD MOLPay unique transaction ID Date & time of the transaction StatCode 2-digit numeric Code Status 00 Success 11 Failure 22 Pending StatName Alphabet Code Success Failure Pending Status captured, settled, ReqCancel, ReqChargeback, authorized failed, cancelled, chargeback, release, reject, blocked Pending, Unknown, TestOK Amount Floating point Transaction amount in one bill 46

48 BillingName VrfKey Alphanumeric Alphanumeric Name use to make a transaction MD5 encrypted string to verify whether the transaction is from valid source. Verify Key is required. Was encrypted as : md5(amount & xxx & Domain & TranID & StatCode) Replace xxx with MOLPay Verify Key 47

49 ii. Direct PSQ (Bank status query) Bank payment status query are merchant initiated process, which allow merchant to get updated status directly from that particular bank for each transaction made with MOLPay payment gateway. Merchant have to follow below API to make them able to be connected to bank inquiry services to get the updated status for their transaction. Parameter passing method : POST or GET Code Definition 0 In Plain text (default) 1 By POST Front-end URL : Parameters : Variable Format Description Name amount Floating point The transaction amount in one bill. txid Integer MOLPay unique Transaction ID domain Alphanumeric MOLPay Merchant ID type Method for merchant to receive response data. url URL Address URL to receive response data from MOLPay. Data will be returned to merchant s system via background (doesn t required browser) skey Alphanumeric Security hash key. Verify key is required. 48

50 Integration example : <?php $skey = md5($txid. $domain. xxxxxxx. $amount); //Replace xxxxxxxx with your MOLPay Verify Key /***************** HTML Format ******************/ echo <a href=' e1c4c60c99116fffc3ce77bd5fd0f7b1'> Update payment status for tranid xxx </a> ;?> Return data : Plain text with new line character (type=0) StatCode: 00 StatName: captured TranID: Amount: Domain: shopa VrfKey: 456cf69e5bddfe8ed POST (type=1) $_POST [StatCode] = 00 ; $_POST [StatName] = captured ; $_POST [TranID] = ; $_POST [Amount] = ; $_POST [Domain] = shopa ; $_POST[VrfKey:]= 456cf69e5bddfe8ed ; Variable Name Format Description StatCode 2-digit numeric Code Status 00 Success 11 Failure 22 Pending StatName Alphabet Code Success Failure Pending Status captured, settled, ReqCancel, ReqChargeback, authorized failed, cancelled, chargeback, release, reject, blocked Pending, Unknown, TestOK TranID Integer MOLPay Unique Transaction ID Amount Floating point Transaction amount in one bill Domain Alphanumeric MOLPay Merchant ID 49

51 VrfKey Alphanumeric MD5 encrypted string to verify whether the transaction is from valid source. Verify Key is required. Was encrypted as : md5(amount & xxx & Domain & TranID & StatCode) Replace xxx with MOLPay Verify Key 50

52 iii. Daily PSQ MOLPay Daily PSQ allow merchant to download a list of transaction of specific date for reconciliation purpose. Parameter passing method POST or GET MOLPay Merchant ID Transaction date. Description Status code to filter the output. It could be : only one status E.g : status=00 combination of more than one status which should be combine using and must be urlencoded E.g : status=urlencode(00 22) let it empty to get the list of transaction for all status. Code Definition 00 Success 11 Failed 22 Pending skey Front-end URL : Parameters Variable Format Name merchantid Alphanumeric rdate YYYY-MM- DD status Alphanumeric Alphanumeric Security hash key. Verify key is required. 51

53 <?php Integration example $skey = md5($rdate. $merchantid. xxxxxxx ); //Replace xxxxxxxx with your MOLPay Verify Key /***************** HTML Format ******************/ echo <a href= daily.php?merchantid=shopa&rdate= &skey=b9d6619ab70e6a9363e8ab426cce326b&status=.urlencode( ). > Update payment status </a> ;?> 52

54 Return data Plain text : each transaction is separated by newline character (\n) and each field is delimited by TAB (\t) character. (type=0) BillingDate OrderID TranID Channel Amount StatCode StatName BillingName :06:26 A MB2u Pending MOLPay Demo :10:45 B MB2u Pending MOLPay Demo Variable Name Format Description BillingDate YYYY-MM-DD Date & time of transaction OrderID Alpha-numeric The bill/invoice number TranID Integer MOLPay Unique Transaction ID Channel Alpha-numeric Payment method for that particular transaction Amount Floating-point Transaction amount in one bill StatCode 2-digit numeric Code Status 00 Success 11 Failure 22 Pending Code Status Success captured, settled, ReqCancel, StatName Alphabet ReqChargeback, authorized Failure failed, cancelled, chargeback, release, reject, blocked Pending Pending, Unknown, TestOK BillingName Alpha-numeric Name use to make a transaction 53

55 iv. Refund Query Payment request refund query are Merchant initiated process, which means query sent from merchant s system to MOLPay to request refund or request cancel of any successful transaction. Currently there s only 1 type of Payment request refund available under MOLPay : i. Single Request Single unique transaction ID is compulsory to perform request transaction refund for this option. MOLPay will return single result based on transaction ID given. Front-end URL: d.php Parameter passing method POST or GET Code Definition 0 In Plain text (default) 1 By POST Parameters Variable Format Description Name txnid Integer MOLPay unique Transaction ID domain Alphanumeric MOLPay Merchant ID type Integer Method for merchant to receive response data. url URL Address URL to receive response data from MOLPay. Data will be returned to merchant s system via background (doesn t required browser) skey Alphanumeric Security hash key. Verify key is required. 54

56 <?php Integration example $skey = md5($txnid. $domain. xxxxxxx ); //Replace xxxxxxxx with your MOLPay Verify Key /***************** HTML Format ******************/ echo <a href= txnid=65234&domain=shopa&skey= e1c4c60c99116fffc3ce77bd5fd0f7b1 > Request refund for this payment </a> ;?> Return data Plain text with new line character (type=0) TranID: Domain: shopa StatDate: :05:21 StatCode: 00 VrfKey: 456cf69e5bddfe8ed POST (type=1) $_POST [TranID] = ; $_POST [Domain] = shopa ; $_POST [StatName] = :05:21 ; $_POST[StatCode] = 00 ; $_POST[VrfKey:]= 456cf69e5bddfe8ed ; Variable Name Format Description TranID Integer MOLPay Unique Transaction ID Domain Alpha-numeric MOLPay Merchant ID StateDate YYYY-MM-DD Response date & time StatCode 2-digit numeric Code Definition 00 Success 11 Failure 12 Invalid/unmatch security hash key 13 Not a Credit Card transaction 14 Transaction more than 3 days 15 Requested day is on settlement day 16 Forbidden transaction VrfKey Alpha-numeric MD5 encrypted string to verify whether the transaction is from valid source. Verify Key 55

57 is required. Was encrypted as : md5(xxx & Domain & TranID & StatCode) Replace xxx with MOLPay Verify Key 56

58 2. PAYMENT STATUS NOTIFICATION i. Callback Query with Instant Payment Notification (IPN) MOLPay Callback Query is the backend notification system initiated by MOLPay used to inform merchant s system automatically on any changes of payment status with MOLPay. This system is suitable for transaction that does not complete the payment loop in MOLPay. By implementing this system, merchant s website able to do some admin controlled functions automatically such as completing orders, products controlling or any other which related to the affected transaction. In order to activate this system, merchant have to defined callback URL on MOLPay Merchant Profile (Figure E-2-i) and related parameters will be submitted to merchant callback URL by POST method (all these values were returned by MOLPay). Merchant have to send feedback to MOLPay by display the word CBTOKEN:MPSTATOK on their callback URL (without the double quotes or any HTML tags) to notified that they have received the response status from MOLPay. This is what we called instant payment notification (IPN) which is 2 way communications in between MOLPay and Merchant during the return response process. Figure E-2-i 57

59 1. Return parameters (by POST method) Variable Name Format Attribute Description nbcb Numeric 1 Code used to notify the incoming to merchant callback URL. amount Floating-point The transaction amount in one bill. orderid Alpha-numeric The bill/invoice number. appcode Alpha-numeric Bank approval code. tranid Integer Transaction ID for tracking purpose domain Alpha-numeric Merchant ID status Numeric 00, 11 or 22 error_code error_desc currency paydate Alpha-numeric Alpha-numeric Alpha-numeric Date/Time YYYY-MM-DD HH:mm:ss skey Alpha-numeric MD5 encryption Status of transaction: 00 - success 11 - failure 22 pending Error code for failure transaction (if any). Error description for failure transaction (if any). Date time of the transaction. Encrypted string to verify whether the transaction is from a valid source. Verify Key is required. 58

60 Example of callback URL script For PHP developer <?php $vkey ="xxxxxx"; //Replace xxxxxxxx with your MOLPay Verify Key /******************************** *Don't change below parameters ********************************/ $nbcb = $_POST['nbcb']; $tranid = $_POST['tranID']; $orderid = $_POST['orderid']; $status = $_POST['status']; $domain = $_POST['domain']; $amount = $_POST['amount']; $currency = $_POST['currency']; $appcode = $_POST['appcode']; $paydate = $_POST['paydate']; $skey = $_POST['skey']; /*********************************************************** * All undeclared variables below are coming from POST method ************************************************************/ $key0 = md5( $tranid.$orderid.$status.$domain.$amount.$currency ); $key1 = md5( $paydate.$domain.$key0.$appcode.$vkey ); if( $skey!= $key1 ) $status= -1; // Invalid transaction if ( $nbcb==1 ) { //IPN feedback to notified MOLPay echo CBTOKEN:MPSTATOK ; } if ( $status == "00" ) { if ( check_cart_amt($orderid, $amount) ) { /*** NOTE : this is a user-defined function which should be prepared by merchant ***/ // action to change cart status or to accept order // you can also do further checking on the paydate as well // write your script here... } } else { // failure action // write your script here... }?> 59

61 For ASP/ASP.NET developer <!--#include file="md5.asp"--> For ASP Developer <!--#include file="md5.aspx"--> For ASP.NET Developer <% md5.asp/md5.aspx is a 3rd party developed md5 solution for ASP/ASP.NET user You could get the md5.asp/md5.aspx from MOLPay support team ' Some variables below are coming from POST method dim key0, key1, tranid, orderid, status, domain, amount, currency, paydate, appcode, skey, nbcb nbcb = Request.Form( nbcb ) tranid = Request.Form( tranid ) orderid = Request.Form( orderid ) status = Request.Form( status ) domain = Request.Form( domain ) amount = Request.Form( amount ) currency = Request.Form( currency ) paydate = Request.Form( paydate ) appcode = Request.Form( appcode ) skey = Request.Form( skey ) key0 = md5( tranid & orderid & status & domain & amount & currency ) key1 = md5( paydate & domain & key0 & appcode & xxxxxx ) Replace xxxxxxxx with your MOLPay Verify Key invalid transaction if the key is different If skey <> key1 then status= -1 End if IPN feedback to notified MOLPay Response.Write CBTOKEN:MPSTATOK If status = "00" then checking the validity of cart amount & orderid. if the verification test passed then can update the order status to paid. you can also do further checking on the paydate as well Else failure action End if %> 60

62 ii. MOLPay Multiple Return URL IMPORTANT NOTICE Merchant MUST pay first before you can start using this feature. Kindly contact our technical support team for this arrangement. Multiple Return URL (front-end return url) has been designed to allow MOLPay active merchant to integrate this online payment service into multiple online shop. This is the advantage for MOLPay merchant as they can just use only ONE MOLPay merchant account on multiple websites whenever they needed. In order to do so, merchant just have to define particular return URL in payment page for each online shop available. At the end of transaction loop, front-end return URL will take an action instead of return URL defined in MOLPay Merchant Profile (back-end return URL). (Refer Figure E-2-ii below) How does it work? 1. Merchant have to define front-end return URL together with others parameter (refer parameters required for integration) and pass it over to payment page. 2. Front-end return URL detected by MOLPay. 3. MOLPay carry on with transaction processing. 4. When transaction loop ended : a) MOLPay will redirect to front-end return URL detected in step (2). Or, b) MOLPay redirect to back-end return URL, if option 4(a) is not available. Figure E-2-ii 61

63 F. REFERENCES REF 1 : List of Country names & code Please note that United Kingdom is GB (instead of UK) REF 2 : PayPal Accepted Currency Currency ISO Code Currency ISO Code U.S Dollar USD Malaysian Ringgit MYR Australian Dollar AUD Mexican Peso MXN British Pound GBP New Zealand Dollar NZD Canadian Dollar CAD Norwegian Krone NOK Czech Koruna CZK Philippine Peso PHP Danish Krone DKK Polish Zloty PLN Euro EUR Singapore Dollar SGD Hong Kong Dollar HKD Swedish Krona SEK Hungarian Forint HUF Swiss Franc CHF Israeli New Shekel ILS Taiwan New Dollar TWD Japanese Yen JPY Thai Baht THB For more info : 62

64 REF 3 : MOLPay FPX Asynchronous Flow Merchant s Secure Payment Page (1) Payer s Internet Banking Account E.g: Maybank2u, CIMB Clicks, etc MEPS FPX Site (2) MOLPay Timer Successful/Unsuccessful Payment (3) b NO Exceed Timeout? YES (3) a Merchant s Store Return URL Merchant s Store Timeout URL How does it work? 1. From merchant s payment page, customer will be directed to MEPS FPX site and from there, customer could either proceed further or to terminate the transaction process immediately. 2. If customer chooses to proceed, they can select any internet banking account from the options provided on MEPS FPX site. At the same time, MOLPay will start the timer and count the duration time (in minutes) of processing transaction. 3. a. If the duration time exceeded merchant timeout (preset in merchant profile), customer will be redirected back to merchant timeout URL. Merchant may display some messages (e.g : Your payment status will be updated accordingly after a few minutes) on the timeout URL 63

65 to acknowledge customer that the system is now processing the final status of the payment. b. Otherwise, system will direct customer back to MOLPay successful/unsuccessful receipt page. 4. From MOLPay successful/unsuccessful receipt page, system will divert customer back to merchant return URL and merchant may update order to the website accordingly. REF 4 : MOLPay Mobile SDK MOLPay is now ready to be integrated into your mobile apps. We have release our own Mobile SDK library. Please contact our sales representative ([email protected]) for this arrangement. 64

66 REF 5 : MOLPay Supported Shopping Cart MOLPay have been integrated with 22 shopping carts, globally. Merchant may refer below list (list to be updated): Cube Cart Drupal Ubercart Easy.my Ecshop estore by Hinetmedia Interspire LJCheckout Magento MyMall NetShop OpenCart Oscommerce Prestashop ShopEx TackThis! Joomla Virtuemart WHMCS WordPress wp-e-commerce ZenCart XCart WHM AutoPilot webshaper Drupal Commerce WordPress WooCommerce CS-Cart nopcommerce ecwid REF 6 : Logos of all brand name Merchant may download the logo from : 65