订单查询接口

本接口为所有支付订单(主扫、被扫)提供查询功能,合作方可以通过该接口主动查询订单(退款单交易除外)交易结果,明确交易结果后进行下一步的业务逻辑。

建议使用条件:

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

results matching ""

    No results matching ""