WEB Payment API

Endpoint

https://payment.lianlianpay.com/payment/traveleasypay.htm

The way to call this API is limited to HTML <form/> post request from client-side. Below <meta> is needed in the head of your HTML.

<meta http-equiv="content-type" content="text/html;charset=UTF-8">

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
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
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
userreq_ip	Required	String(32)	The IP address of your customer, used for anti-fraud purpose. Replace "." with "_", E.g. 122_11_37_211
url_order	Optional	String(255)	Online url of products
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
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
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

Sample Request

<form action="https://payment.lianlianpay.com/payment/traveleasypay.htm" method="post"> 
    <input type="text" name="version" value="1.0">
    <input type="text" name="oid_partner" value="201304121000001004">
    <input type="text" name="user_id" value="111111">
    <input type="text" name="timestamp" value="20180301175839">
    <input type="text" name="busi_partner" value="101001">
    <input type="text" name="no_order" value="2013099129111111">
    <input type="text" name="dt_order" value="20130224120224">
    <input type="text" name="name_goods" value="测试商品">
    <input type="text" name="info_order" value="测试商品信息">
    <input type="text" name="money_order" value="49.95">
    <input type="text" name="notify_url" value="http://domain:port/notify">
    <input type="text" name="url_return" value="http://domain:port/return">
    <input type="text" name="userreq_ip" value="*.*.*.*">
    <input type="text" name="pay_type" value="M">
    <input type="text" name="sign_type" value="RSA">
    <input type="text" name="sign" value="RSA签名结果">
    <input type="submit" value="立即支付">
</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
ret_code	Required	String(4)	Return code. Refer to return codes
ret_msg	Required	String(100)	Return message, description of ret_code, in Chinese
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
settle_date	Optional	String(8)	Format YYYYMMDD. Returns when payment is successful
info_order	Optional	String(255)	Returns when info_order is sent in API requests
pay_type	Optional	String	The payment method used in this transaction. 0, balance payment 1, online banking payment (debit card) 8, online banking payment (credit card) 9, business online banking payment 2, express payment (debit card) 3, express payment (credit card) D, verified payment I, WeChat Payment L, Alipay Payment
bank_code	Optional	String	Short codes of banks

There is no need to send response for synchronous notification.

Sample Synchronous Notification

<form action="<url_return>" method="post"> 
    <input type="text" name="ret_code" value="0000">
    <input type="text" name="ret_msg" value="支付成功">
    <input type="text" name="oid_partner" value="201304121000001004">
    <input type="text" name="sign_type" value="RSA">
    <input type="text" name="sign" value="{sign}">
    <input type="text" name="dt_order" value="20130224120224">
    <input type="text" name="no_order" value="2013099129111111">
    <input type="text" name="oid_paybill" value="2013099129232322">
    <input type="text" name="money_order" value="49.95">
    <input type="text" name="settle_date" value="20140109">
    <input type="text" name="info_order" value="备注">
    <input type="text" name="pay_type" value="M">
    <input type="text" name="bank_code" value="01020000">
</form>