业务功能
根据商户订单号或者具体公司订单号查询公司的具体订单信息。
交互模式
后台系统调用交互模式
请求 url：http://pay.xrtpay.com/xrtpay/gateway
通过 get 或 POST XML 内容体进行请求
请求参数列表
| 字段名 |
变量名 |
必填 |
类型 |
说明 |
| 接口类型 |
service |
是 |
String(32) |
unified.trade.query |
| 版本号 |
version |
否 |
String(8) |
默认值是2.0。 |
| 字符集 |
charset |
否 |
String(8) |
默认为 UTF-8。 |
| 签名方式 |
sign_type |
否 |
String(8) |
取值：MD5 默认：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优先。 |
| 随机字符串 |
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下的唯一标识 |
| 是否关注公众账号 |
is_subscribe |
否 |
Int |
用户是否关注公众账号，0-关注， 1-未关注，仅在公众账号类型支付有效 |
| …订单号 |
transaction_id |
是 |
String(32) |
…交易号。 |
| 商户订单号 |
out_trade_no |
是 |
String(32) |
商户系统内部的定单号， 32 个字符内、 可包含字母 |
| 总金额 |
total_fee |
是 |
Int |
总金额， 以分为单位， 不允许包含任何字、符号 |
| 现金券金额 |
coupon_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。 该时间取…服务器 |
文档更新时间: 2021-03-06 11:16 作者：杨敏
