Help2Pay Deposit Integration Specification Ver 1.1.10 1
Help2Pay Deposit Integration Specification Ver 1.1.10 1
Help2Pay Deposit Integration Specification Ver 1.1.10 1
Integration
Specification
Version 1.1.10
Contents
2
Help2Pay Deposit Integration Specification Ver 1.1.10 3
Executive Summary
E-Commerce businesses have evolved to an unprecedented height today. With internet services
becoming more affordable, the exponentially growing of internet users have preferred to shop,
pay bills, etc online. Millions of people spend billions of dollars on this borderless marketplace.
The existence of online payment solutions can be seen. They act as a bridge or gateway to
guarantee the payments from the consumers to merchants are made instantly, efficiently and
securely. It truly enhances online shoppers' experience. Just few clicks away, shopping or paying
bills online can be such a breeze.
We strongly believe that our existence will to make a difference in every shoppers' or payees
'lives, allowing secured and timely transactions. By running 24/7 daily, we make sure our
payment system serves you, anytime, anywhere. By partnering with major banks, integrating
into numerous payment providers' networks, we built a comprehensive range of solutions,
catering to the needs of merchants in different markets.
3
Help2Pay Deposit Integration Specification Ver 1.1.10 4
Introduction
Help2Pay is an interesting design of web interface that incorporated in 2014.In order to provide
an outstanding online payment solution to the consumers and clients, Help2Pay stands on one
strong belief. The project exists in order to make a difference for every consumer by providing
an effective and secured automated transaction on a real time basis.
Meanwhile, Help2Pay provide as a middle man to effective assist consumers by simplify the
process of completing purchasing transaction with merchandizer and help clients to monitor
their business transaction at real time basis.
We have a secure and responsive network of people handling your business. No compromise
will ever be taken into consideration. YOU ARE OUR PRIORITY. We thrive to be the best in the
market, providing our clients nothing less than our utmost efforts.
4
Help2Pay Deposit Integration Specification Ver 1.1.10 5
This document is to provide a guidance to our client in order to have a deeper understanding on
Help2Pay’s business transaction flows and web services functions that facilitate the system
integration with the merchant’s e-commerce application.
The manual is to provide a guidance for system developers, administrators and maintenance
personnel whom may use the services of Help2Pay application. To be able to fully utilize the
manual guide, one’s is required to have basic knowledge as below:
5
Help2Pay Deposit Integration Specification Ver 1.1.10 6
Gateway – Help2Pay
Merchant – Help2Pay’s merchants (could imply as the server or the website itself)
Deposit Submission – A valid submission to Gateway by the Merchant in the deposit process
Deposit Result – A returned result to Merchant by the Gateway after the fund transfer process is
completed.
6
Help2Pay Deposit Integration Specification Ver 1.1.10 7
7
Help2Pay Deposit Integration Specification Ver 1.1.10 8
The Gateway uses standard html web form submission via HTTP Post to establish the Deposit
transfer. The table listing below shown the parameters needed for doing that.
Important
❗Do not send blank customer ID
❗Do not send same customer ID for
different user
Key String 1~500 Yes A generated hash key for determining the
validity of the payment submission by the
merchant to gateway to prevent fraudulent
activity. (Please refer to the topic of Security
Hashing below)
Important
*VND and IDR currency Will Only Allow .00
decimal submission.
Example:
VND 10000.00 > able to be submit
VND 10000.15 > not able to be submit
8
Help2Pay Deposit Integration Specification Ver 1.1.10 9
FrontURI String 1~500 Yes The URL to receive transaction status from
Gateway to Merchant that will display the
transaction status to customer in
Merchant’s front-end site.
Bank String 1~50 Yes Bank code provided by the Gateway. Please
refer appendix for list of bank code.
Precondition:
1. Single company name: Do provide
company name to CS to verify it matched
with the record in system
2. Multiple companies name: Do provide a
listing of company name to CS for matching
purpose
9
Help2Pay Deposit Integration Specification Ver 1.1.10 10
HTML Sample
10
Help2Pay Deposit Integration Specification Ver 1.1.10 11
After the Deposit Submission process, the gateway calls back the Merchant’s backend URL
(BackURI provided during merchant’s Deposit Submission) with corresponding Deposit Result. At
the same time, the gateway redirects the Customer back to the Merchant website (FrontURI
provided on merchant Deposit Submission) and displays the status to the Customer.
The table listing below show details of the variables returned in the result.
11
Help2Pay Deposit Integration Specification Ver 1.1.10 12
To generate the Key hash, Merchant is required to use cryptographic hash function,
MD5 to hash the combination of details (Merchant, Reference, Customer, Amount,
Currency, and Datetime) during Deposit Submission, by using the SecurityCode. Details
as shown below:
MD5({Merchant}{Reference}{Customer}{Amount}{Currency}{Datetime}{SecurityCode}{ClientIP})
• Merchant = “M00001”
• Reference = “T123456789”
• Customer = “CUST1001”
• Amount = “12.00”
• Currency = “MYR”
• Datetime = “2012-05-21 08:04:00PM”
• SecurityCode = “eQIkGnUeK”
• ClientIP = “128.199.171.73”
Notes:
12
Help2Pay Deposit Integration Specification Ver 1.1.10 13
During the Deposit process, every single Deposit result will be returned to Merchant upon
completion. Similarly, the Key is also used for the Deposit Result for verifying the
response from the Gateway to the Merchant.
The Deposit Result will only be considered as valid when the generated encryption hash
matches with Key.
To generate the Key hash, Merchant is required to use cryptographic hash function,
MD5 to hash the combination of details (Merchant, Reference, Customer, Amount and
Currency) by using the SecurityCode.
{Key} = MD5({Merchant}{Reference}{Customer}{Amount}{Currency}{Status}{SecurityCode})
• Merchant = “M00001”
• Reference = “T123456789”
• Customer = “CUST1001”
• Amount = “12.00”
• Currency = “MYR”
• StatusCode = ”000”
• SecurityCode = “eQIkGnUeK”
Notes:
13
Help2Pay Deposit Integration Specification Ver 1.1.10 14
Appendix
14
Help2Pay Deposit Integration Specification Ver 1.1.10 15
15
Help2Pay Deposit Integration Specification Ver 1.1.10 16
16
Help2Pay Deposit Integration Specification Ver 1.1.10 17
17
Help2Pay Deposit Integration Specification Ver 1.1.10 18
Language Code
en-us English
th Thai
id-id Indonesian
bur Burmese
18
Help2Pay Deposit Integration Specification Ver 1.1.10 19
Error Code
AccountSetting User’s bank account not able to login/bank account setup not
complete
ATMApproveRequired ATM approve is required
19