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 ifno_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="
}
Last updated