代收代付订单查询

Tips：

（1）系统中代收和代付订单接口参数相同，只是接口URL地址不同。

（2）系统中支持根据商户订单号和系统订单号查询，查询按照不同的URL地址区分，两种查询返回参数一样。

1 按照商户订单号查询(建议)

代收订单查询请求URL

• https://api.fast-vip.com/api/payGate/searchOrderByMerOrderNo

代付订单查询请求URL

• https://api.fast-vip.com/api/agentPay/searchOrderByMerOrderNo

请求方式

• POSTJSON

请求示例

{
    "orderNo": "202408140448287515188641",
    "sign": "8d39746085a7c1990eb0297e68f13225",
    "merchantNo": "mer545331"
}

请求参数

参数名	必选	类型	说明
merchantNo	是	string	商户编码
orderNo	是	string	商户系统订单号
sign	是	string	签名

2 按照系统订单号查询

代收订单查询请求URL

• https://api.fast-vip.com/api/payGate/searchOrder

代付订单查询请求URL

• https://api.fast-vip.com/api/agentPay/searchOrder

请求方式

• POSTJSON

请求示例

{
    "sysOrderNo": "202408140448287515188641",
    "sign": "8d39746085a7c1990eb0297e68f13225",
    "merchantNo": "mer545331"
}

请求参数

参数名	必选	类型	说明
merchantNo	是	string	商户编码
sysOrderNo	是	string	注意：下单接口返回的系统订单号
sign	是	string	签名

3 返回结果

返回示例

{
    "code": "10000",
    "message": "成功",
    "merchantNo": "mer545331",
    "orderNo": "1723582108929",
    "sysOrderNo": "202408140448287515188641",
    "orderAmount": "1000.00",
    "sucOrderAmount": "1000.00",
    "orderTime": "2024-08-14 04:48:29",
    "resultTime": "2024-08-14 04:53:30",
    "status": "1"
}

返回参数说明

参数名	类型	说明
code	String	响应代码 10000 查询成功，具体订单结果根据status确定。 20007 订单不存在 40001 获取商户信息失败 40003 商户白名单IP不正确 40004 签名错误 40005 商户状态已关闭 在商户生产环境中，非10000时建议订单进入人工核实状态。
message	String	请求响应说明
merchantNo	String	商户编号
orderNo	String	商户订单号
sysOrderNo	String	系统订单号
orderAmount	String	交易金额
sucOrderAmount	String	实际成交金额，在某些国家产品中实际成功金额可能和提交金额有稍微差异
orderTime	String	下单时间
resultTime	String	交易完成时间
status	String	状态 0处理中 1成功 2失败