订单查询接口
本接口为所有支付订单(主扫、被扫)提供查询功能,合作方可以通过该接口主动查询订单(退款单交易除外)交易结果,明确交易结果后进行下一步的业务逻辑。
建议使用条件:
1、当合作方后台、网络、服务器等出现异常,系统未接收到网商银行系统返回;
2、调用支付接口后,返回交易状态为未知的情况;
3、调用撤销交易之前,需调用交易查询确认支付状态。
注意:为避免资损发生,当合作方系统发起回查订单,网商银行系统反馈订单不存在后,该订单号无法再进行创建支付订单操作。
2.1.1请求参数POST json 内容体进行请求
POST json 内容体进行请求
字段名 | 变量名 | 是否必填 | 类型 | 请明 |
---|---|---|---|---|
接口类 | Method | 是 | String(8 ) | PayQuery |
字符集 | Charset | 是 | String(8 ) | 只支持 UTF-8 |
签名方 式 | SignType | 否 | String(8 ) | 签名类型,取值:MD5 默认:MD5 |
门店号 | ShopNo | 是 | String(3 2) | 商户号,由小蜜蜂商家平台分配 |
随机字 符串 | NonceStr | 是 | String(3 2) | 随机字符串,不长于 32 位 |
商户订 单号 | OutTradeNo | 是 | String(3 2) | 商户系统内部的订单号 |
签名 | Sign | 是 |
2.2.2返回参数 返回结果
状态 码 | Code | 是 | int | 当Code>0时,交易有错误 |
---|---|---|---|---|
错误信息 | Msg | 是 | String(3 2) | 错误消息 |
数据体 | Data | 是 |
Data数据结构
参数名 | 参数描述 | 数据类型 | 长度 | 出现要求 | 示例 |
---|---|---|---|---|---|
RespInfo | 返回码组件。当ResultStatus=S时才有后续的参数返回。 | [返回码]对象 | M | ||
OutTradeNo | 外部交易号。 | String | 64 | ME | |
OrderNo | 网商支付订单号 | String | 64 | M | |
OrderType | 支付单类型。枚举值:create:主扫pay:被扫create_dynamic:动态扫码 | String | 16 | M | |
TradeStatus | 支付状态。枚举值:succ:支付成功fail:失败paying:支付中closed:已关单cancel:已撤消 | String | M | ||
下面的参数仅TradeStatus=succ才返回 | |||||
ChannelType | 支付渠道类型 | String | M | ||
TotalAmount | 交易总额度,货币最小单位,如人民币:分 | Number | M | ||
Currency | 币种。默认CNY。 | String | M | ||
MerchantId | 商户号。网商为商户分配的商户号,通过商户入驻结果查询接口获取。 | String | 64 | M | |
IsvOrgId | 合作方机构号(网商银行分配) | String | 64 | M | |
Body | 商品描述。该信息将透传至第三方支付公司系统,并在客户端明细中展示。格式要求:店名-销售商品类目。 | String | 128 | M | |
GoodsTag | 商品标记。微信支付代金券或立减优惠功能的参数。 | String | 32 | O | |
GoodsDetail | 商品详情列表。微信支付单品优惠功能字段,JSON格式base64编码,会透传至第三方支付。 | String | O | ||
OpenId | 消费者用户标识。用户在商户subappid下的唯一标识。若商户使用合作机构的subappid,则返回合作机构下的用户唯一标识 | String | 128 | O | |
OperatorId | 操作员ID | String | 32 | O | |
StoreId | 门店ID | String | 32 | O | |
DeviceId | 终端设备号(门店号或收银设备ID)。 | String | 32 | O | |
SettleType | 清算方式。可选值:T0:T+0清算按笔清算T1:T+1汇总清算 | String | 32 | M | |
Attach | 附加信息,原样返回。 | String | 128 | O | |
GmtPayment | 支付完成时间 | datetime | 128 | M | 格式"yyyy-MM-dd HH:mm:ss" |
BankType | 付款银行。银行类型,仅使用微信支付时有返回值。详细列表参看附录3。 | String | 16 | O | CCB_Credit |
IsSubscribe | 用户是否关注商户公众号,仅微信支付有效。Y:关注;N:未关注 | String | 1 | O | 仅微信.Y/N |
PayChannelOrderNo | 支付宝或微信端的订单号,可用于打印小票给客户核对 | String | 64 | C | |
MerchantOrderNo | 商户订单号。该订单号与支付宝、微信支付客户端账单详情显示的商户订单号一致,通过该订单后可发起扫码退款或查询交易。特别说明:支付宝的交易与OutTradeNo一致。微信支付的订单号为威富通的订单号“transaction_id”该字段2017年9月30日提供线上服务。 | String | 64 | C | |
SubAppId | 子商户appid。仅微信返回。该字段2017年9月30日提供线上服务。 | String | 64 | O | |
CouponFee | 现金券金额。仅微信返回,现金券支付金额<=订单总金额,订单总金额-现金券金额为现金支付金额。该字段2017年9月30日提供线上服务。 | Number | O | ||
BuyerLogonId | 买家支付宝登录账号。该字段2017年9月30日提供线上服务。 | String | 128 | O | 159****5620 |
BuyerUserId | 买家支付宝用户id。该字段2017年9月30日提供线上服务。 | String | 128 | O | 2088101117955611 |
Credit | 借贷标识。可选值:credit:信用卡pcredit:花呗(仅支付宝)debit:借记卡balance:余额unknown:未知该字段2017年9月30日提供线上服务。 | String | 1 | O | 1 |
ReceiptAmount | 实收金额,商户实际入账的金额(扣手续费之前)。仅支付宝返回。该字段2017年9月30日提供线上服务。 | Number | O | ||
BuyerPayAmount | 用户实付金额,建议打印在小票上避免退款时出现纠纷。仅支付宝返回。该字段2017年9月30日提供线上服务。 | Number | O | ||
InvoiceAmount | 开票金额,快速告知商户应该给用户开多少钱发票。仅支付宝返回。该字段2017年9月30日提供线上服务。 | Number | O | ||
CnlMsg | 支付结果返回信息,包括渠道错误原因,JSON格式base64编码,本期只提供微信支付返回信息,例如对于失败交易,可通过解析return_msg、err_code_des字段来查看具体失败原因,具体字段内容参考微信支付平台开发文档https://pay.weixin.qq.com/wiki/doc/api/jsapi_sl.php?chapter=9_2 | String | O |