H5 Payment API

Endpoint

https://wap.lianlianpay.com/travlepay.htm

The way to call this API is limited to HTML <form/> post request from client-side. All of the required parameters should be embedded into a <input> tag whose name is req_data:

<form action="https://wap.lianlianpay.com/travlepay.htm" method="POST">
    <input name="req_data" value='{$value}'>
</form>

Request Parameters

Name	Required	Type	Description
version	Required	String	Fixed value, 1.0
oid_partner	Required	String(18)	The unique identification assigned to the merchant. E.g. 201304121000001004
platform	Optional	String(32)	platform is used for sharing user info between multiple oid_partner, this requires additional settings from LianLian side
user_id	Required	String(32)	The unique identification assigned to the user in the merchant’s system
app_request	Required	String(1)	1, Android 2, iOS 3, H5
timestamp	Required	String(14)	The time when request is initialized. Format: yyyyMMddHHmmss, E.g. 20170801225714. The time difference between your server and LianLian server(UTC +8) should be no more than 30 mins
sign_type	Required	String(3)	RSA
sign	Required	String	Signature value
bg_color	Optional	String(6)	The background color of payment pages. Range: 000000 ~ ffffff. By default is ff5001
font_color	Optional	String(6)	The font color of payment pages. Range: 000000 ~ ffffff
syschnotify_flag	Optional	String(1)	0, Redirect only when the return button is clicked 1, Redirect automatically How the user is redirected after completing payments, by default is 0
busi_partner	Required	String(6)	Fixed value. Virtual products, 101001; Physical products, 109001
no_order	Required	String(32)	Merchant order No.
dt_order	Required	String(14)	Merchant order date. Format: yyyyMMddHHmmss, E.g. 20170801225714
name_goods	Required	String(40)	Product name. E.g. Pen
info_order	Optional	String(255)	info_order will be sent back in synchronous or asynchronous notification for parameters transmission
money_order	Required	String(12)	Merchant order amount, range: 0.01 ~ 100,000,000.00, 2 decimal places are expected, in CNY
notify_url	Required	String(128)	Online url where asynchronous notification should be sent, E.g. http://www.lianlianpay.com/help/notify
url_return	Optional	String(128)	Online url, your customer will be redirected to url_return once they finished their payment
back_url	Optional	String(128)	The url where user is redirected when they need to change cards. For payment info preset only
no_agree	Optional	String(32)	A token which represents the key payment information, refer to Binding Card for more details
valid_order	Optional	Int	The valid period of no_order, in minute. The status of corresponding transaction will be set to "Closed" once its valid_order run out. Default: 10080 (7 days).
pay_type	Required	String	M, regular payments F, authorization, used for credit card only. An error throws out if the used card is not a credit card
risk_item	Required	String	This parameter is used for payment risk control, all required parameters should be included in the value of risk_item in json format, refer to Payment Risk
acct_name	Optional	String	The name of payer, in Chinese
card_no	Optional	String	User's card number
id_type	Optional	String(1)	0, ID card 2, Passport 3, Military Officer Certificate 4, Hong Kong-Macau laissez-passer 6, Mainland travel permit for Taiwan residents 9, Police Officer card X, other certificates
id_no	Optional	String	The number of User's ID card. The length need to be either 15 or 18

id_no, acct_name, id_type, card_no are ignored if no_agree is present.

Sample Request

<form action="https://wap.lianlianpay.com/travlepay.htm" method="post"> 
    <input name="req_data" value='{
        "oid_partner":"201103171000000000",
        "dt_order":"20130515094013",
        "no_order":"2013051500001",
        "busi_partner":"101001",
        "name_goods":"羽毛球",
        "info_order":"用户13958069593购买羽毛球3桶",
        "money_order":"210.97",
        "notify_url":"http://.../notify_url.shtml",
        "url_return":"http://.../return_url.htm",
        "back_url":"http://.../back_url.htm",
        "risk_item":"{\"frms_ware_category\":\"2009\",\"user_info_mercht_userno\":\"123456\",\"user_info_dt_register\":\"20141015165530\",\"user_info_full_name\":\"张三\",\"user_info_id_no\":\"3306821990012121221\",\"user_info_identify_type\":\"1\",\"user_info_identify_state\":\"1\"}",
        "valid_order":"30",
        "sign_type ":"RSA",
        "sign":"ZPZULntRpJwFmGNIVKwjLEF2Tze7bqs60rxQ22CqT5J1UlvGo575QK9z/+p+7E9cOoRoWzqR6xHZ6WVv3dloyGKDR0btvrdqPgUAoeaX/YOWzTh00vwcQ+HBtXE+vPTfAqjCTxiiSJEOY7ATCF1q7iP3sfQxhS0nDUug1LP3OLk="
        }'/>
</form>

Synchronous Notification

Payment synchronous notification, a HTTP POST request, will be sent to url_return whenever the payment or the authorization is confirmed as successful. No synchronous notification is sent for failed transactions or transactions with exception.

Synchronous notification sends only once, we recommend you to use asynchronous notification or payment result query API to obtain payment result.

Parameters

Name	Required	Type	Description
oid_partner	Required	String(18)	The unique identification assigned to the merchant. E.g. 201304121000001004
sign_type	Required	String(3)	RSA
sign	Required	String	Signature value
no_order	Required	String(32)	Merchant order No.
dt_order	Required	String(14)	Merchant order date. Format: yyyyMMddHHmmss, E.g. 20170801225714
oid_paybill	Required	String(18)	Unique transaction No. in LianLian system. E.g. 2011030900001098
money_order	Required	String(12)	Merchant order amount, range: 0.01 ~ 100,000,000.00, 2 decimal places are expected, in CNY
result_pay	Required	String	Payment result. E.g. SUCCESS
settle_date	Optional	String(8)	Format YYYYMMDD. Returns when payment is successful

There is no need to send response for synchronous notification.

Sample Synchronous Notification

{url_return}?res_data={
    "oid_partner":"201103171000000000",
    "dt_order":"20130515094013",
    "no_order":"2013051500001",
    "oid_paybill":"2013051613121201",
    "money_order":"210.97",
    "result_pay":"SUCCESS",
    "settle_date":"20130516",
    "sign_type":"RSA", 
    "sign":"ZPZULntRpJwFmGNIVKwjLEF2Tze7bqs60rxQ22CqT5J1UlvGo575QK9z/+p+7E9cOoRoWzqR6xHZ6WVv3dloyGKDR0btvrdqPgUAoeaX/YOWzTh00vwcQ+HBtXE+vPTfAqjCTxiiSJEOY7ATCF1q7iP3sfQxhS0nDUug1LP3OLk="
}