MERCHANT INTEGRATION GUIDE. Version 2.7

Transcription

1 MERCHANT INTEGRATION GUIDE Version 2.7

2 CHANGE LOG 1. Showed accepted currencies per payment option. 2. Added validation for RUB payments. INTRODUCTION MegaTransfer provides a wide range of financial services available worldwide: from transferring money and exchanging currencies, to financial institutions and banking alternatives. But one of the most common use of payment system like MegaTransfer, is to accept payments from clients via merchant perspective. Once registered and successfully verified by MegaTransfer, merchants can integrate the payment gateway (or we can call it here as MTG stands for MegaTransfer Gateway) instantly. One great attribute of MTG is that it allows merchants to accept four (4) different types of payment methods by just installing a single block of code. The following payment types are accepted by MTG: 1. VISA and MasterCard 2. MegaTransfer Wallet 3. China UnionPay 4. Wire Transfer This manual should help merchants to implement and integrate MTG to their respective online shops. We ensure each and every merchants a safe and secure payment environment between their website and to MTG server.

3 PARAMETERS The following parameters are needed in order for us to integrate properly the MTG. All API requests must be sent to by POST method. items quantity amount currency total_amount merchant_id order_id client_name client_country client_city client_ client_regdate url selected product to be bought by client (alphanumeric, required) number of items (numeric, required) price of the item (float, required) Credit Cards (EUR, GBP, USD, RUB) MegaTransfer Wallet (EUR, USD, GBP, AED, AUD, BTC, CAD, CHF, CNY, CZK, DKK, HKD, HUF,ILS, INR, JPY, KWD, LTC, LTL, NOK, NZD, PHP, PLN, RON, RUB, SAR, SEK, SGD) China UnionPay (EUR, USD, GBP, AED, AUD, CAD, CHF, CNY, CZK, DKK, HKD, HUF,ILS, INR, JPY, KWD, LTL, NOK, NZD, PHP, PLN, RON, RUB, SAR, SEK, SGD) Wire Transfer (EUR, USD, GBP, CZK, NOK, SEK, CHF, CAD, AUD, DKK, HKD, JPY, NZD, PLN, RUB, SGD) quantity * amount (float, required) your merchant ID; please check setup (required) order ID from merchant s system (required) Name of end user inside Merchant's system. (required) Country name or country code of end user inside Merchant's system. (required) City of end user inside Merchant's system. (required) address of end user inside Merchant's system. (required) Registration date of end user inside Merchant's system. (required) URL on merchant's system triggered by end users before entering MegaTransfer process (required) gateway_id 0 for test gateway, 1 for live gateway (required) Use this test account username for test gateway: Username: testmegatransfer@gmail.com Password: testmt@1234 signature composed of hash ("sha256",(secret code + separator + merchant_id + separator + items + separator + quantity + separator + amount + separator + total_amount + separator + currency + separator + secret code)) where : secret code indicated in your merchant setup separator indicated in your merchant setup (required) CALLBACK PAGES Callback pages are pages where client will be redirected after performing payments. The following are the callback pages:

4 Wire Transfer Message URL default address of page where client will be redirected after wire transfer payment request Success URL default address of page where client will be redirected after successful payment Fail URL default address of page where client will be redirected when an error occurred during payment Callback URL default address of page for performing and receiving POST variables in JSON format through curl method. RETURN PARAMETERS items quantity amount currency total_amount merchant_id order_id transaction_id message token selected product to be bought by client (alphanumeric, required) number of items (numeric, required) price of the item (float, required) EUR, USD, GBP, AED, AUD, BTC, CAD, CHF, CNY, CZK, DKK, HKD, HUF, ILS, JPY, KWD, LTC, LTL, NOK, NZD, PHP, PLN, RON, RUB, SAR, SEK, or SGD.(required) quantity * amount (float, required) your merchant ID; please check setup (required) order ID from merchant s system (required) reference number from Megatransfer system error messages (for failed transactions only) composed of hash ("md5",(secret code + order_id + transaction_id + secret code)) where : secret code indicated in your merchant setup (for success transactions only)

5 IMPLEMENTATION When clients of the merchant selects Megatransfer as their payment method, clients are actually sending data to MegaTransfer s web servers through safe and secure connection. Data sent by clients contains the payment information that makes up the behavior of MTG. Shopping Cart Process Page contains items, quantity, amount, currency and total_amount to be posted on Process Page. contains items, quantity, amount, currency total_amount, order_id and signature to be posted in MTG. Initially, when MTG is successfully implemented, merchants are only allowed to use two (2) payment methods the MegaTransfer Wallet and Wire Transfer. In order to start accepting VISA, MasterCard, and CUP (China UnionPay), merchants need to submit verification documents that supports the idea that their business is in good standing. Once verified, MegaTransfer will automatically add the remaining payment methods on merchant s MTG setup. WIRE TRANSFER API Wire Transfer can be added as a payment option by switching it ON from Merchant Setup page. All transactions paid to you by your clients can be tracked using this link: ID]/[MERCHANT KEY]/[ORDER ID] Both Merchant ID and Merchant Key can be found on your Merchant Setup page. Order ID is optional. Leaving it blank will list all payment transactions under your merchant account, otherwise, it will show records based on that specific Order ID.

6 SAMPLE CODE STRUCTURES STRUCTURE OF PHP REQUEST <?php $items = $_POST["items"]; $quantity = $_POST["quantity"]; $amount = $_POST["amount"]; $currency = $_POST["currency"]; $client_name = $_POST["client_name"]; $client_country = $_POST["client_country"]; $client_city = $_POST["client_city"]; $client_ = $_POST["client_ "]; $reg_date = $_POST["client_regdate"]; $url = " $merchant_id = " "; $secret_code = "6c417hg8eaef344c41b8ffggh56064cdfe13101dc28bbnx9b03bbb34c7e96dbdf4"; $separator = " "; $order_id = strtotime("now"); $total_amount = (int) $quantity * (float) $amount; $total_amount = sprintf("%1.2f",$total_amount); $signature = hash("sha256",$secret_code.$separator.$merchant_id.$separator.$items.$separator.$quantity. $separator.$amount.$separator.$total_amount.$separator.$currency. $separator.$secret_code);?> <html> <body onload="document.form.submit();"> <form id="form" name="form" method="post" action="<?php echo " <input type="hidden" name="items" value="<?php echo $items?>"/> <input type="hidden" name="quantity" value="<?php echo $quantity?>"/> <input type="hidden" name="amount" value="<?php echo $amount?>"/> <input type="hidden" name="currency" value="<?php echo $currency?>"/> <input type="hidden" name="total_amount" value="<?php echo $total_amount?>"/> <input type="hidden" name="merchant_id" value="<?php echo $merchant_id?>"/> <input type="hidden" name="order_id" value="<?php echo $order_id?>"/> <input type="hidden" name="client_name" value="<?php echo $client_name?>"/> <input type="hidden" name="client_country" value="<?php echo $client_country?>"/> <input type="hidden" name="client_city" value="<?php echo $client_city?>"/> <input type="hidden" name="client_ " value="<?php echo $client_ ?>"/> <input type="hidden" name="client_regdate" value="<?php echo $reg_date?>"/> <input type="hidden" name="url" value="<?php echo $url?>"/> <input type="hidden" name="signature" value="<?php echo $signature?>"/> //FOR TEST GATEWAY <input type="hidden" name="gateway_id" value="<?php echo "0"?>"/> //FOR LIVE GATEWAY <input type="hidden" name="gateway_id" value="<?php echo "1"?>"/> </form> </body> </html> <body onload="document.form.submit();"> <form id="form" name="form" method="post" action="<?php echo " <input type="hidden" name="items" value="<?php echo $items?>"/> <input type="hidden" name="quantity" value="<?php echo $quantity?>"/>

7 <input type="hidden" name="amount" value="<?php echo $amount?>"/> <input type="hidden" name="currency" value="<?php echo $currency?>"/> <input type="hidden" name="total_amount" value="<?php echo $total_amount?>"/> <input type="hidden" name="merchant_id" value="<?php echo $merchant_id?>"/> <input type="hidden" name="order_id" value="<?php echo $order_id?>"/> <input type="hidden" name="signature" value="<?php echo $signature?>"/> //FOR TEST GATEWAY <input type="hidden" name="gateway_id" value="<?php echo "0"?>"/> //FOR LIVE GATEWAY <input type="hidden" name="gateway_id" value="<?php echo "1"?>"/> </form> </body> </html> STRUCTURE OF JSON RESPONSE Failed {"items":"clothes","quantity":"2","amount":"2.00","currency":"usd","total_amount":"4.00","merchant_id":" ", "order_id":" ","status":"failed","message":"internal error on the system. Please contact support."} Success {"items":"clothes","quantity":"2","amount":"50.00","currency":"usd","total_amount":" ","merchant_id":" ", "user_id":"74","order_id":" ","token":"66baa1bf b0f154bca39f0e","tr ansaction_id":" ","status":"success"} STRUCTURE OF PHP CALLBACK <?php parse_str(file_get_contents("php://input"),$_post); $response = $_POST["response"]; $response = json_decode($response,true); $items = $response["items"]; $quantity = $response["quantity"]; $amount = $response["amount"]; $currency = $response["currency"]; $merchant_id = $response["merchant_id"]; $order_id = $response["order_id"]; $status = $response["status"]; $secret_code = "6c417hg8eaef344c41b8ffggh56064cdfe13101dc28bbnx9b03bbb34c7e96dbdf4"; if($status == "success"){ $transaction_id = $response["transaction_id"]; $token = $response["token"];

8 if($token == hash("md5",$secret_code.$order_id.$transaction_id.$secret_code)){ //your statement here //update your database for success transaction } } else { $message = $response["message"]; //your statement here //update your database for fail transaction }?> CONTACT US For assistance on how to integrate MTG, please contact us through following methods: support@megatransfer.co.uk Phone Skype mtuk.support