GT PAYMENT PTE. LTD.
GTPayment Merchant Integration Manual
Version: <1.2.1>
Page 1 of 7
GT PAYMENT PTE. LTD.
Whats New in version 1.2.0? 1. Price format limit. Only number or decimal point Whats New in version 1.2.1? 1. Take out the Moneybookers payment method (Not support any more) 2. Describe more details about mcurrency, price, actual_currency, actual_amount difference.
Page 2 of 7
GT PAYMENT PTE. LTD.
1. Standard gateway 1.1 Introducation Easy-to-use gateway interface enabling businesses and individuals to sell goods and services over the Internet safely and securely. The customer makes the payment on GTPayment's secure web servers. He is automatically redirected back to the merchant's web site once the payment is complete. Allows real-time communication between the merchant's system and GTPayment's transaction servers. 1.2 Description Parameter Name lang member productid price product membercurrency ucancel ureturn unotify api_exclude Type string string string Double (10,2) String String String String String String Description Language for the GTPayment page The merchant Email in GTPayment Unique id Total price Product Name Product currency MUST BE the same as merchant currency in GTPayment Cancel url Return url Notify url Merchant can choose payment gateway NOT to use (Paypal,alipay) Can be Null Y default English N N N Y N N N Y Y
Table 1: API Request Notes: Form POST URL: https://www.gtpayment.com/payment.do (Live) http://sandbox.gtpayment.com/payment.do (Sandbox) lang: Now support two languages Chinese (zh-CN)/English (en-US) member: the merchant have to register in GTPayment. The user email address in GTPayment is the member name here. api_exclude: Merchant can choose payment gateway NOT to use. Price: Character must be number or decimal point (Cannot be include special character e.g. ,)
Page 3 of 7
GT PAYMENT PTE. LTD.
1.3 Example For basic integration simply use this HTML and customise the Orange fields to your own needs: <form method="post" action=" https://www.gtpayment.com/payment.do"> <input type="hidden" name="lang" value="zh-CN" /> <input type="hidden" name="member" value="GTPay account" /> <input type="hidden" name="productid" value="123456" /> <input type="hidden" name="product" value="Test Item" /> <input type="hidden" name="price" value="10.00" /> <input type="hidden" name="membercurrency" value="SGD" /> <input type="hidden" name="ucancel" value="Cancel URL" /> <input type="hidden" name="ureturn" value="Return URL" /> <input type="hidden" name="unotify" value="Notify URL" /> <input type="hidden" name="api_exclude" value="alipay,paypal" /> <input type="submit" value="PAY NOW" /> </form>
*Note: api_exclude value=alipay,paypal so the payment gateway will not use alipay and paypal
Page 4 of 7
GT PAYMENT PTE. LTD.
2. Response: A sample response code: Status=Completed&member=test&checksign=NAU60gbapbhKPs8XGfmJ9Z57Y4qPWPvOMMKtKt biGELK5dUgy5&price=10&mcurrency=USD&actual_amount=14&actual_currency=SGD Parameter Name status member checksign price mcurrency actual_amount actual_currency productid product transactionid Type string string string Double (10,2) string Double (10,2) string string string string Description Completed Pending Failed The merchant email address in GTPayment API Key of GTPayment Total price the merchant get currency of the merchant Actual price the buyer pay Actual currency the buyer pay Product ID Product Name GTPayment transaction ID Can be Null N N N N N N N Y N
Table 2: API Response
Notes: Notify URL: POST Method to transfer the value checksign: to double check the merchant is right or not transactionid: GTPayment transaction ID checksign: The unique API Key of GTPayment mcurrency: The merchant payment gateway currency price: The merchant payment gateway total price actual_currency: Actual currency the buyer paid, Just for reference actual_amount: Actual price the buyer paid, Just for reference
Page 5 of 7
GT PAYMENT PTE. LTD.
After the user register in GTPayment, go to the overview page of GTPayment, API Keys tab
Figure 1: API Keys screenshot
Page 6 of 7
GT PAYMENT PTE. LTD.
3. Flow Chat
Server Website Payment Button GTPayment API Request
Your Customers
Your Site
Process URL Your Return/Cancel Site
Your Back-office and administrative processes
Your Office
GTPayment API Response
Figure 2: Process flow chat
Page 7 of 7
