支付结果查询

POST/mch/v1/accp/txn/order-query

该接口提供公共的支付订单查询，商户可以通过该接口主动查询订单状态，完成下一步的业务逻辑。
该接口适用于：

交易记账结果查询
担保确认结果查询
内部代发结果查询
测试环境：https://mpay-openapi-ste2.lianlianpay.com/query-api/mch/v1/accp/txn/order-query

请求参数

mch_id

string

商户编号

必需

商户在平台上开设的商户号码，为18位数字

<= 18 字符

示例值:

2020042200284052

sub_mchid

string | null

子商户编号

可选

子商户编号

<= 18 字符

示例值:

302210180000021525

txn_seqno

string

商户订单号

可选

商户系统唯一订单号

<= 32 字符

platform_txno

string

平台订单号

可选

连连订单唯一编号

{
  "mch_id": "2020042200284052",
  "sub_mchid": "302210180000021525",
  "txn_seqno": "string",
  "platform_txno": "string"
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

ret_code

string

交易结果代码

必需

见码表

>= 4 字符<= 4 字符

ret_msg

string

交易结果描述

必需

<= 100 字符

mch_id

string

商户编号

必需

商户在平台上开设的商户号码，为18位数字，如：201304121000001004

sub_mchid

string

子商户编号

可选

user_id

string

所属用户编号

必需

用户在商户系统中的唯一编号

<= 64 字符

txn_seqno

string

商户订单号

必需

商户系统唯一订单号

<= 32 字符

txn_time

string <date-time>

商户支付订单时间

必需

<= 14 字符

正则匹配:

YYYYMMDDH24MISS

busi_type

enum<string>

业务类型

必需

枚举值:

100001100002100099120001120002130001

platform_txno

object (平台订单号)

平台订单号

必需

platform_txno

string

平台订单号

可选

连连订单唯一编号

<= 20 字符

order_amount

number

订单总金额

必需

该笔订单的资金总额，单位为RMB-元。大于0的数字，精确到小数点后两位。如：49.65

order_info

string

订单描述

必需

<= 255 字符

txn_status

enum<string>

交易结果

必需

枚举值:

SUCCESSFAILUREPROCESSINGCLOSEDCANCEL

account_date

string <date>

交易账期

可选

成功时返回

>= 8 字符<= 8 字符

正则匹配:

YYYYMMDD

balance_info

object

余额支付付款方信息

可选

当余额支付、担保确认、内部代发等时返回

user_id

string

用户唯一编号

可选

用户在商户系统中的唯一编号

<= 64 字符

user_type

enum<string>

用户类型

必需

枚举值:

MCHUSER

supplement_info

object

交易记账信息

可选

交易记账单返回

group_no

string

上账分组标记

必需

现阶段需要提前报备

supplement_date

string <date>

上账外部账期

必需

上账所属外部账期用于控制资金清算核对，即它表示该笔交易资金所属外部账期。默认不填写，则为发生当日，该笔交易会参与隔日对账；若填写，则表示补指定某一天的交易，例如20210701补单少补了一笔，隔日发现对账不平后，通过指令可额外补0701的交易，不允许填写未来的日期。

默认值:

正则匹配:

yyyyMMdd

payee_info

array [object {5}]

收款方信息

必需

payee_id

string

收款方ID

可选

payee_type为USER时，必填。

<= 64 字符

payee_type

enum<string>

收款方类型

必需

枚举值:

MCHUSER

payee_accttype

enum<string>

收款方账户类型

必需

枚举值:

USEROWNMCHOWNMCHCOUPONMCHFEEUSERDEFINED

payee_amount

string

收款方金额

必需

payee_memo

string

收款方备注

可选

<= 255 字符

未设置