普通线上业务不需要对接此接口,对接创建订单和支付通知就可以实现业务流程,使用此接口需要联系客服申请。
商户可以通过查询订单接口主动查询订单状态,完成下一步的业务逻辑。
查询订单可通过 支付星支付订单号 和 商户订单号 两种方式查询。
需要调用查询接口的情况:
- 当商户后台、网络、服务器等出现异常,商户系统最终未接收到支付通知。
接口说明
支持用户:【VIP用户 且 商户的业务系统订单号唯一的用户】
接口地址:V1接口地址/api/queryOutOrder
请求方式:POST
参数传递:Query
查询频率:3秒
Content-Type:application/x-www-form-urlencoded
接口地址:在支付FM商户后台【用户中心】处查看【接口地址】对应的值。
支持
HTTP
与HTTPS
,您可按需选择。
如果你的业务网站开启了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 | 支付状态文字描述。枚举值:未支付,支付成功 |