商户可以通过查询订单接口主动查询订单状态,完成下一步的业务逻辑。

查询订单可通过 支付星支付订单号 和 商户订单号 两种方式查询。

需要调用查询接口的情况:

  • 当商户后台、网络、服务器等出现异常,商户系统最终未接收到支付通知。
  • 调用支付接口后,返回系统错误或未知交易状态情况。

接口说明

支持用户:【商户订单号唯一的用户】
请求方式:POST【接口地址】/api/queryOutOrder
参数传递:Query
Content-Type:application/x-www-form-urlencoded
接口地址:在支付FM商户后台【用户中心】处查看【接口地址】对应的值。

支持HTTPHTTPS,您可按需选择。
如果你的业务网站开启了https访问,请使用https开头的接口地址请求接口。

请求参数值说明

参数 必须 类型 说明
merchantNum string query商户号。在支付FM商户后台【用户中心】处可查看,该值不是用户名。
orderNo string query商户订单号,如果你的商户订单号不是唯一的,不要用这个接口。
sign string query签名。待签名字符串进行MD5加密得出的32位签名值,小写。待签名字符串=商户号+商户订单号+接入密钥;其中“+”表示字符串拼接,请注意拼接顺序。接入密钥在支付FM商户后台【用户中心】处可查看。

返回参数值说明

参数 必须 类型 说明
success boolean 正常标志
code number 信息编码。200代表正常。此编码非HTTP状态码,别混淆了。
timestamp number 毫秒时间戳。
msg string 信息描述。
data json 数据内容。

data内容参数:

参数 必须 类型 说明
amount string 订单金额。订单查询成功有值
merchantNum string 商户号
orderId string 平台订单号
orderNo string 商户订单号
payType string 支付方式编码
success_time string 支付时间,未支付状态没有值
tradeState string 支付状态。枚举值:NOTPAY ,SUCCESS
tradeStateDesc string 支付状态文字描述。枚举值:未支付,支付成功

参考示例

商户订单号查询订单 - 图1