FuturePay 收单订单查询

1.请求地址（POST）

实时 API: https://api.futurepay.global/payin/orderQuery

沙盒 API: https://api.futurepay-develop.com/payin/orderQuery

2.请求参数（JSON 格式）

参数可以 二选一传入：

参数名	类型	必填	说明
merchantReference	String	否	商户订单号
pspReference	String	否	FuturePay 平台订单号

{
  "merchantReference": "商户订单号（可选）",
  "pspReference": "平台订单号（可选）"
}

注意： merchantReference 和 pspReference 至少需传一个

3.响应参数（JSON格式）

顶层字段

参数名	类型	示例值	描述
code	String	"0"	响应码，0 表示成功
msg	String	"success"	响应消息
serverTime	Long	1747904980771	服务器时间戳（毫秒）
success	Boolean	true	请求是否成功
data	Object	见下表	订单数据对象

data 字段内参数

参数名	类型	示例值	描述
merchantReference	String	"3753595377629466860"	商户订单号
pspReference	String	"1925475282161106944"	FuturePay 平台订单号
resultCode	String	"SUCCEED"更多结果可参考该地址	订单处理结果
refusalReason	String	null	拒绝原因（如有）
amount	Object	见下表	支付金额信息
providerReference	String	"202505221940109000001888A0234862571"	支付渠道方订单号（
paymentMethod	String	"cards"	支付方式（如 cards, alipay 等）

amount 字段内参数

参数名	类型	示例值	描述
currency	String	"USD"	币种代码
value	Long	1299	支付金额，单位为“分”

示例：


{
  "code": "0",
  "msg": "success",
  "serverTime": 1747904980771,
  "data": {
    "merchantReference": "3753595377629466860",
    "pspReference": "1925475282161106944",
    "resultCode": "SUCCEED",
    "refusalReason": null,
    "amount": {
      "currency": "USD",
      "value": 1299
    },
    "currency": null,
    "providerReference": "202505221940109000001888A0234862571",
    "paymentMethod": "cards"
  },
  "success": true
}