Payment Result Query API
Last updated
Last updated
This API is available for you to query the status of a specific transaction of Exchange Payment. Before we start, you need to learn the change of transaction status.
There are 6 statuses for an Express Payment transaction object:
CREATED， this status is the initial transaction status, which is changed to WAITING immediately after transaction object creation。
PROCESSING， which means the transaction is processing by our gateways. Generally this status lasts for 3 minute, if we can't obtain the result from our gateways during this period, it would be changed to WAITING. In this case, we would setup a for corresponding transaction.
WAITING，there are several cases for this transaction status:
The payer never complete the verification step.
The payer have finished the verification step but we haven't obtain the payment result from our gateways.
SUCCESS， the transaction is paid successfully.
REFUND， the transaction is refunded。
FAILURE， the transaction is never paid hence it is closed as the validity period runs out. The validity period is set by parameter valid_order in .
All the transaction status other than SUCCESS can only be obtained by .
Transaction recovery mechanism is used for rare cases whenever LianLian submit a payment request to our gateways but never get the expect response. In this case, a polling is performed to keep asking for the payment results, which is the major of transaction recovery mechanism.
By default, the transaction recovery mechanism would expand the validity period of one transaction to 7 days. Contact our technical support if you want it to be shorter. The recommended minimum period is 2 hours.
According to the validity period of one transaction, there are 2 cases if transaction recovery mechanism obtain the payment result successfully:
The transaction is still in its validity period. Its status would be changed to SUCCESS and we do the relevant logic.
The transaction is closed. In this case, we will not change the transaction status and do refund to the payer directly.
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
no_order
Required
String(32)
Merchant transaction No.
oid_paybill
Optional
String(18)
Unique transaction No. in LianLian system. E.g. 2011030900001098
Name
Required
Type
Description
ret_code
Required
String(4)
ret_msg
Required
String(100)
Return message, description of ret_code, in Chinese
The following parameters are returned only when ret_code=0000:
Name
Required
Type
Description
oid_partner
Required
String(18)
The unique identification assigned to the merchant. E.g. 201304121000001004
sign_type
Required
String(3)
Fixed value, RSA
sign
Required
String
no_order
Required
String(32)
Merchant transaction No.
dt_order
Required
String(14)
The date when the transaction is initialized. Format: yyyyMMddHHmmss, E.g. 20170801225714
oid_paybill
Required
String(18)
Unique transaction No. in LianLian system. E.g. 2011030900001098
result_pay
Required
String
Payment result. SUCCESS PROCESSING WAITING REFUND FAILURE
memo
Optional
String
The remark of transaction, this field may include the failed reason of the transaction
currency_order
Required
String(3)
money_order
Required
String(12)
Merchant transaction amount, range: 0.01 ~ 100,000,000.00, 2 decimal places are expected, in the currency of currency_order
The following parameters are returned only when result_pay=SUCCESS:
Name
Required
Type
Description
settle_date
Optional
String(8)
Format YYYYMMDD.
info_order
Optional
String(255)
Returns when info_order is sent in API requests
pay_type
Optional
String(1)
The pay type used in current transaction.
currency_settle
Required
String(3)
The settle currency of transaction
money_settle
Required
String(12)
The settle amount of transaction
currency_pay
Required
String(3)
money_pay
Required
String(12)
The amount of which the payer payed
exchange_rate
Required
String
The exchange rate of current transaction
no_agree
Optional
String(16)
Below is a sample whose result_pay=SUCCESS:
Signature value, refer to
Return code, whether the request is handled successfully or not. Refer to
Signature value, refer to
The currency used in the transaction. Refer to
The currency of which the payer used. Refer to
A token which represents the key payment information, refer to for more details