Unified Merchants API (UMAPI) Java Integration Quick Guide Credit Browser-to-Server Flow

Transcription

1 A BETTER WAY TO PAY Unified Merchants API (UMAPI) Java Integration Quick Guide Version 1.0 Page enets UMAPI Java Merchant Integration Manual

2 Contents 1 Minimum System Requirements Installing the UMAPI JARs Reference Document Transaction Flow Diagram Transaction Flow Description Sample Code - Creating the Credit Payment Request message (Step 2) Sample Code Processing Credit Payment Notification message (Step 3) and Creating Credit Notification Acknowledgement (Step 3.1) Sample Code Processing Credit Payment Response message (Step 4)... 6 Appendix D Change History... 8 Page i v1.0

3 1 Minimum System Requirements - A machine with at least 64M RAM and hard disk space of 125MB or more. - The Merchant API runs operating systems that support JRE version 1.6 and above. 2 Installing the UMAPI JARs - Unzip the UMAPI package provided into a preferred directory (eg. D:\umapi). - All the JAR files in D:\umapi\CLIENT\lib are to be added into CLASSPATH of the merchant server s startup script. 3 Reference Document - enets Java UMAPI Implementation Guide [1] 4 Transaction Flow Diagram Figure 1 depicts the enets UMAPI Credit Browser-to-Server transaction flow from a merchant system s perspective. Transaction interactions which are essential to the flow but do not involve merchant system have been excluded. This is to avoid distracting the merchant system integrators. 5. Receipt Page 1. Pay 2. Credit Payment Request (redirection) 4. Credit Payment Response (redirection) 3. Credit Payment Notification (server-to-server) 3.1. Credit Payment Acknowledgement Page 2 v1.0

4 5 Transaction Flow Description Figure 2 provides the descriptions of the transaction flow sequence. Customer Merchant enets Start 1. Submits Pay request to Merchant website using HTTPS. 2. Creates the Credit Payment Request. Embeds it in the HTTPS response for the Customer. 2. Browser receives the Credit Payment Request and redirects it to enets Gateway. 3. Processes the Credit Payment Request and sends a server-toserver Credit Payment Notification to Merchant Processes the Credit Payment Notification and reply a Credit Notification Acknowledgment to enets Gateway. 4. Processes Credit Payment Notification Acknowledgment, embeds a Credit Payment Response and reply to the Customer 4. Redirects Credit Payment Response to Merchant. 4. Processes Credit Payment Response and display receipt page to Customer. 5. Browser display receipt page. End Page 3 v1.0

5 6 Sample Code - Creating the Credit Payment Request message (Step page import="com.wiz.enets2.transaction.util.*, com.wiz.enets2.transaction.umapi.data.*, com.wiz.enets2.transaction.umapi.*, org.apache.commons.lang.*, java.util.*" TxnReq req = new TxnReq(); CreditTxnReq credreq = new CreditTxnReq(); // Merchant to set the following variables. Refer to Message Format section of [1] for the fields details. String mid =???; String tid =???; String paymentmode =???; String amt =???; String currency =???; String merref =???; String submitmode =???; String mercertid =???; String pan =???; String expiry =???; String stan =???; String paymenttype =???; String successurl =???; String successurlparams =???; String failureurl =???; String failureurlparams =???; req.setnetsmid(mid); req.settid(tid); req.setpaymentmode(paymentmode); req.settxnamount(amt); req.setcurrencycode(currency); req.setmerchanttxnref(merref); req.setsubmissionmode(submitmode); req.setmerchantcertid(mercertid); req.setsuccessurl(successurl); req.setsuccessurlparams(successurlparams); req.setfailureurl(failureurl); req.setfailureurlparams(failureurlparams); req.setnotifyurl(request.getparameter("notify_url")); req.setnotifyurlparams(request.getparameter("notify_url_params")); credreq.setpan(pan); credreq.setexpirydate(expiry); credreq.setpaymenttype(paymenttype); credreq.setstan(stan); credreq.setcardholdername(request.getparameter("name")); Page 4 v1.0

6 credreq.setcvv(request.getparameter("cvv")); credreq.setposturl(request.getparameter("post_url")); credreq.setposturlparams(request.getparameter("post_url_params")); credreq.setcancelurl(request.getparameter("cancel_url")); credreq.setcancelurlparams(request.getparameter("cancel_url_params")); req.setcredittxnreq(credreq); CreditMerchant m = (CreditMerchant) Merchant.getInstance (Merchant.MERCHANT_TYPE_CREDIT); <html> <head></head> String smsg = m.formpayreq(req); if(smsg!= null &&!smsg.equals("")) { String url = (String)StringEscapeUtils.escapeHtml(request.getParameter((String)StringEscapeUtils.escapeHtml(("gw_url")))); <body onload="document.txnform.submit()"> <form name="txnform" action="=url" method="post"> <input type="hidden" name="message" value="=smsg"> </form> </body> } else { <h1>error FORMING PAYMENT REQUEST!</h1> } } </html> Page 5 v1.0

7 7 Sample Code Processing Credit Payment Notification message (Step 3) and Creating Credit Notification Acknowledgement (Step page import="com.wiz.enets2.transaction.util.*, com.wiz.enets2.transaction.umapi.data.*, com.wiz.enets2.transaction.umapi.*" String smsg = request.getparameter("message"); CreditMerchant m = (CreditMerchant) Merchant.getInstance(Merchant.MERCHANT_TYPE_CREDIT); TxnNotify notify = m.unpacknotification(smsg); CreditNotify crednotify = notify.getcreditnotify(); if (crednotify == null) crednotify = new CreditNotify(); TxnAck ack = new TxnAck(); CreditAck credack = new CreditAck(); ack.setnetstxnref(notify.getnetstxnref()); ack.setmerchanttxnref (notify.getmerchanttxnref()); ack.setmerchanttxnstatus ("0000"); ack.setmerchantcertid("1"); ack.setnetsmid(notify.getnetsmid()); ack.setcreditack(credack); smsg = m.formack (ack); out.println(smsg); System.out.println("Notify has been sent " + notify.getnetstxnref()); 8 Sample Code Processing Credit Payment Response message (Step page import="com.wiz.enets2.transaction.util.*, com.wiz.enets2.transaction.umapi.data.*, com.wiz.enets2.transaction.umapi.*" String smsg = request.getparameter("message"); CreditMerchant m = (CreditMerchant) Merchant.getInstance(Merchant.MERCHANT_TYPE_CREDIT); TxnRes res = m.unpackresponse(smsg); CreditTxnRes credres = res.getcredittxnres(); if (credres == null) credres = new CreditTxnRes(); <html> <head></head> <body> Page 6 v1.0

8 <table width="100%"> <tr colspan="2"> enets II Merchant Simulator Success URL.</tr> <tr><td>mid:</td> <td><input type="text" name="mid" value="=res.getnetsmid()"/></td></tr> <tr><td>merchant Txn Ref: </td> <td><input type="text" name="merchant_txn_ref" value="=res.getmerchanttxnref()"/></td> </tr> <tr><td>nets Txn Ref: </td> <td><input type="text" name="nets_txn_ref" value="=res.getnetstxnref()"/></td></tr> <tr><td>nets Txn Time: </td> <td><input type="text" name="nets_txn_dtm" value="=res.getnetstxndtm()"/></td> </tr> <tr><td>nets Txn Status: </td> <td><input type="text" name="nets_txn_status" value="=res.getnetstxnstatus()"/></td></tr> <tr><td>nets Txn Response Code:</td><td><input type="text" name="nets_txn_resp_code" value="=res.getnetstxnrespcode()"/></td> </tr> <tr><td>nets Txn Msg: </td> <td><input type="text" size="40" name="nets_txn_msg" value="=res.getnetstxnmsg()"/></td> </tr> <tr><td>nets Amt Deducted: </td> <td><input type="text" name="nets_amt_deducted" value="=credres.getnetsamountdeducted()"/></td> </tr> <tr><td>bank Auth ID: </td> <td><input type="text" name="bank_auth_id" value="=credres.getbankauthid()"/></td> </tr> </table> </body> </html> Page 7 v1.0

9 Appendix D Change History Version No. Revision No. Description Approval Date 1 0 Initial Release 1 Aug 2016 Page 8 v1.0