Redirect API

This redirect API is suitable for aggregate payment on pc websites.

Endpoint

https://wallet.lianlianpay.com/aggregateweb/gateway.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.1

oid_partner

Required

String(18)

The unique identification assigned to the merchant. E.g. 201304121000001004

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).

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

col_oidpartner

Optional

String(18)

oid_partner of recipient, which is mainly used in LianLian E-wallet. The value is set as oid_partner to which user_id belongs by default.

col_userid

Optional

String(32)

user_id of recipient, which is mainly used in LianLian E-wallet. Note there is only one recipient, col_userid and col_oidparnter can not be used in a same request

shareing_data

Optional

String(1024)

Refer to Sharing data introduction

secured_partner

Optional

String(18)

oid_partner of guarantor, which is mainly used in guaranteed transactions. Refer to LianLian E-wallet documentation for more details

buyer_confirm_valid

Optional

Int

seller_send_valid

Optional

Int

id_no

Optional

String

Only ID card is supported, the length need to be either 15 or 18. Required for Verified Payment

acct_name

Optional

String

The name of payer, in Chinese. Required for Verified Payment

bank_code

Optional

String

Specify which online banking should be used instead of displaying online banking selection page. bank_code to be used with pay_type.

pay_type

Optional

String

1, online banking payment(debit card) 8, online banking payment(credit card) 9, business online banking payment pay_type to be used with bank_code.

Sample Request

<form action="ENDPOINT" 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="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="test item">
    <input type="text" name="info_order" value="some info">
    <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="risk_item" value='{"user_info_bind_phone":"13958069593","user_info_dt_register":"20131030122130","frms_ware_category":"1009","request_imei":211,"request_imsi":121121,"request_ip":"192.168.20.110"}'>
    <input type="text" name="url_order" value="http://domain:port/orderUrl">
    <input type="text" name="sign_type" value="RSA">
    <input type="text" name="sign" value="YOUR-RSA-SIGN-RESULT">
    <input type="submit" value="checkout">
</form>

Parameter shareing_data is mainly used for revenue sharing. Max recipients: 3.

Sharing_account^Sharing_account_type^Sharing_amount^Sharing_description|Sharing_account^Sharing_account_type^Sharing_amount^Sharing_description|Sharing_account^Sharing_account_type^Sharing_amount^Sharing_description

Sharing_account, can either be user_id or oid_partner .
Sharing_account_type, fixed value. 0 for LianLian E-wallet merchant, 1 for regular merchant.
Sharing_amount, revenue sharing amount, 2 decimal places are expected, in CNY.
Sharing_description, a short description for revenue sharing, no "^" nor "|", length: 85.

Aggregate Payment Synchronous Notification

Payment synchronous notification, a HTTP POST request, will be sent to url_return whenever the payment is confirmed as successful.

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

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.

PreviousOverview NextDirect API

Last updated 7 years ago

Endpoint

Request Parameters

Sample Request

Sharing Data Introduction

Aggregate Payment Synchronous Notification

Parameters