Welcome to our Payment Gateway System

Our powerful web-based online payment services platform, a trusted solution utilized by numerous renowned companies and organizations in the region. Our system offers a secure, multi-channel, multi-lingual, and multi-currency payment experience.

Integration Methods:

Choose the integration method that best suits your needs:

Purpose of this Document:

This technical specification document prescribes the constituent parts of specification for integration of an e-commerce web site with PayDollar/SiamPay/PesoPay e-commerce service, the on-line payment service by AsiaPay (HK) Limited, by subscribed merchants of the service. This document has been created to ensure that all technical specifications contain sufficient information to enable a merchant to design and modify the codes of an existing on-line shopping architecture or software to cater for the payment –enabling service. It also provides a checklist to enable the reviewers of specifications to conduct tests on the functionalities of the integration.

Enhanced Security with 3DS 2.0:

There is an extra parameter section under each connection method. That section is especially designed for 3DS 2.0 (Three Domain Secure 2.0). 3DS authentication is an additional security layer for card-not-present transactions. With 3DS 2.0, it is aimed to achieve a better, stronger fraud-detection intelligence.

Merchant API Functions:

In a later section, we'll provide an in-depth description of the various API functions available to subscribed merchants, ensuring a seamless integration process.

Thank you for choosing our payment gateway system. Let's get started.

Following are the three methods of Web Integration

To use data feed function, merchant has to create a data feed page and inform payment gateway system about the location of your page (e.g. http://www.yourdomain.com/datafeed.jsp). Merchant can enable or disable this function in the merchant administration site.

There are totally four API functions provided:

• Capture Authorized Payment
• Void Accepted Payment
• Request Refund Accepted Payment
• Query Payment Status

To connect to our system, you need to post the required parameters by HTML form posting to our merchant API web page and then get back the processing result from that page. You can implement it by server-side html post.

URL of Testing Platform:

Beside, a set of API login ID and password will be assigned to your merchant account for accessing this API function. And it can be obtained from us by sending a request email or directly contact us.

The aim of this function is to capture the authorized payment.

The aim of this function is to void the accepted payment before settlement. It can be done only before our settlement time

The aim of this function is to request refund for accepted payment before 14 days.

The aim of this function is to query the payment status on an order by either Merchant Reference Number or Payment Reference Number with XML

The aim of this function is to query the payment request log.

XML

Select...
<records>
<record>
<requestDate>2016-01-20 10:17:19</requestDate>
<sessionId>1135335</sessionId>
<ref>Test</ref>
<cur>344</cur>
<amt>1</amt>
<payerIp>192.168.77.28</payerIp>
<ipCountry/>
<deviceBrowser>Chrome</deviceBrowser> 
<deviceOS/>
<deviceMoblie>F</deviceMoblie>
<channelType>SPC</channelType>
<pageCode>CPF</pageCode>
</record> 

The aim of this function is to cancel the payment that the status of transaction in pending status.

The aim of this function is to void / refund / partial refund the payment online according to its order status.

To connect to our system, you need to post the required parameters by HTML form posting to our merchant API web page and then get back the processing result from that page. You can implement it by server-side html post.

SHELL

Select...
https://test.paydollar.com/b2cDemo/eng/merchant/api/onlineApi.jsp

The aim of this function is to generate settlement report.

SHELL

Select...
https://test.paydollar.com/b2cDemo/GenTxnXML

Sample source code of HTML server-side posting on Java

As different type of programming language have different syntax, so we just propose one method to connect to our merchant API page. To connect, we suggest you to use server side posting:

JAVA

Select...
// SET UP THE POST DATA
String postData =
"merchantId=1&loginId=testing&password=pwd&payRef=123456&actionType=Capture&amount=
1 & ”;
// POST TO PAYMENT PAGE
strResult = ServerPost.post(postData,
http: //test.paydollar.com:8080/b2cDemo/eng/merchant/api/orderApi.jsp );
// EXTRACT THE PAYMENT STATUS FROM STRRESULT
………
// FINISH
**
** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** ** **
public class ServerPost {
static public String post(String ip_postData, String ip_pageUrl) {
try {
String strResult = "";
URL url = new URL(ip_pageUrl);
URLConnection con = url.openConnection(); //from secure site
if (con instanceof com.sun.net.ssl.HttpsURLConnection) {
((com.sun.net.ssl.HttpsURLConnection) con).setSSLSocketFactory
((SSLSocketFactory) SSLSocketFactory.getDefault());
}
con.setDoOutput(true);
con.setDoInput(true);
// Set request headers for content type and length
con.setRequestProperty(
"Content-type",
"application/x-www-form-urlencoded");
con.setRequestProperty(
"Content-length",
String.valueOf(ip_postData.length()));
// Issue the POST request
OutputStream outStream = con.getOutputStream();
outStream.write(ip_postData.getBytes());
outStream.flush();
// Read the response
InputStream inStream = con.getInputStream();
while (true) {
int c = inStream.read();
if (c == -1)
break;
strResult = strResult + String.valueOf((char) c);
}
inStream.close();
outStream.close();
return strResult;
} catch (Exception e) {
System.out.print(e.toString());
return null;
}
}
}

All the source code in this document are the property of AsiaPay (HK) Limited. Any use, modification and adaptation to the code should be reported to and approved by AsiaPay (HK) Limited. AsiaPay (HK) Limited do not have any liability in any lose to the party using the source code.

This section explains various scenarios of transactions, other than good and successful transactions that may occur.

Australia

China

Hong Kong

India

Indonesia

Japan

Korea

Macau

Malaysia

Philippines

Singapore

Taiwan

Thailand

Vietnam