文档名称
统一查询接口文档
业务功能
根据商户订单号或者平台订单号查询订单信息。
交互模式
后台系统调用交互模式
请求 url：https://pay.xrtpay.cn/xrtpay/gateway
通过 POST XML 内容体进行请求
请求参数列表
| 字段名 |
变量名 |
必填 |
类型 |
说明 |
| 接口类型 |
service |
是 |
String(32) |
unified.trade.query |
| 版本号 |
version |
否 |
String(8) |
默认值是2.0。 |
| 字符集 |
charset |
否 |
String(8) |
默认为 UTF-8。 |
| 签名方式 |
sign_type |
否 |
String(8) |
取值：MD5或者sm3 默认：MD5 |
| 商户号 |
mch_id |
是 |
String(32) |
商户号， 由技术人员分配 |
| 商户订单号 |
out_trade_no |
否 |
String(32) |
商户系统内部的订单号, out_trade_no和transaction_id 至少一个必填， 同时存在时transaction_id 优先 |
| 平台订单号 |
transaction_id |
否 |
String(32) |
平台订单号 , out_trade_no 和transaction_id至少一个必填，同时存在时transaction_id优先。 |
| 交易时间 |
trade_date |
否 |
string(8) |
交易时间，为空则查当天或者昨天 |
| 随机字符串 |
nonce_str |
是 |
String(32) |
随机字符串， 不长于 32 位 |
| 签名 |
sign |
是 |
String(32) |
MD5 签名结果，详见“数字签名 MD5 签名规则” |
返回结果
数据按 XML 的格式实时返回
| 字段名 |
变量名 |
必填 |
类型 |
说明 |
| 版本号 |
version |
是 |
String(8) |
默认值是 2.0。 |
| 字符集 |
charset |
是 |
String(8) |
默认为 UTF-8。 |
| 签名方式 |
sign_type |
否 |
String(8) |
取值： MD5 默认： MD5 |
| 返回状态码 |
status |
是 |
String(16) |
0 表示成功非 0 表示失败此字段是通信标识， 非交易标识， 交易是否成功需要查看 trade_state 来判断 |
| 返回信息 |
message |
否 |
String(128) |
返回信息， 如非空，为错误原因签名失败参数格式校验错误 |
| 业务结果 |
result_code |
是 |
String(16) |
0 表示成功非 0 表示失败 |
| 商户号 |
mch_id |
是 |
String(32) |
商户号， 由技术部分配 |
| 设备号 |
device_info |
否 |
String(32) |
终端设备号 |
| 随机字符串 |
nonce_str |
是 |
String(32) |
随机字符串， 不长于 32 位 |
| 错误代码 |
err_code |
否 |
String(32) |
具体错误码请看文档最后错误码列表 |
| 错误代码描述 |
err_msg |
否 |
String (128) |
结果信息描述 |
| 签名 |
sign |
是 |
String(32) |
MD5 签名结果， 详见“数字签名 MD5 签名规则” |
| 以下字段在 status 和 result_code 都为 0 的时候有返回 |
| 交易状态 |
trade_state |
是 |
String(32) |
SUCCESS—支付成功 REFUND—转入退款 NOTPAY—未支付 CLOSED—已关闭 REVOKED—已冲正 USERPAYING—用户支付中 PAYERROR—支付失败(其他原因， 如银行返回失败) |
| 以下字段在 trade_state 为 success 的时候有返回 |
| 交易类型 |
trade_type |
是 |
String(16) |
pay.weixin.micropay pay.qq.micropay pay.alipay.micropay |
| 用户标识 |
openid |
否 |
String(128) |
用户在商户 appid下的唯一标识 |
| 优惠详情 |
promotion_detail |
否 |
string(6000) |
优惠详情 |
| 平台订单号 |
transaction_id |
是 |
String(32) |
平台订单号。 |
| 商户订单号 |
out_trade_no |
是 |
String(32) |
商户系统内部的定单号， 32 个字符内、 可包含字母 |
| 总金额 |
total_fee |
是 |
Int |
总金额， 以分为单位， 不允许包含任何字、符号 |
| 货币种类 |
fee_type |
否 |
String(8) |
货币类型，符合ISO 4217标准的三位字母代码，默认人民币： CNY |
| 附加信息 |
attach |
否 |
String(128) |
商家数据包， 原样返回 |
| 付款银行 |
bank_type |
否 |
String(16) |
银行类型 |
| 银行订单号 |
bank_billno |
否 |
String(32) |
银行订单号,若为微信支付则为空 |
| 支付完成时间 |
time_end |
是 |
String(14) |
支付完成时间， 格式为 yyyyMMddhhmmss，如2009 年 12月27日 9 点 10 分 10 秒表示为20091227091010。 时区为 GMT+8 beijing。 该时间取…服务器 |
| 折扣详情 |
discount_goods_detail |
否 |
string(1000) |
折扣详情 |
| 结算金额 |
settlement_total_fee |
否 |
int |
结算金额，单位为分 |
文档更新时间: 2022-03-03 16:42 作者：EricYang
