FuturePay 收单订单查询

1.请求地址（POST）

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

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

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 等）
additionalData	Object	请参考示例响应	费用信息

amount 字段内参数

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

additionalData对象字段

字段名	类型	说明
ACQUIRING_FEE	Object	固定费
DISCOUNT_FEE	Object	百分比手续费
GATEWAY_FEE	Object	网关费
IOF_FEE	Object	税费

金额对象结构（ACQUIRING_FEE/ DISCOUNT_FEE/ GATEWAY_FEE）

字段名	类型	说明
`currency`	String	币种，例如：`UGX`（乌干达先令）
`value`	String	金额，精确到小数点后10位

示例：

{
    "code": "0",
    "msg": "success",
    "serverTime": 1784022863898,
    "data": {
        "merchantReference": "BB910AADF2C849369E2C393387B9AEB6",
        "pspReference": "2076964133567332352",
        "resultCode": "SUCCEED",
        "amount": {
            "currency": "USD",
            "value": 200
        },
        "providerReference": "202607141140108001001886I0281206515",
        "paymentMethod": "pix",
        "completeTime": "2026-07-14T09:38:21.000+00:00",
        "orderCreateTime": "2026-07-14T09:37:39.000+00:00",
        "orderType": "transaction",
        "additionalData": {
            "ACQUIRING_FEE": {
                "currency": "USD",
                "value": "0"
            },
            "IOF_FEE": {
                "currency": "BRL",
                "value": "5.185000000"
            },
            "DISCOUNT_FEE": {
                "currency": "BRL",
                "value": "10"
            },
            "GATEWAY_FEE": {
                "currency": "USD",
                "value": "0"
            }
        }
    },
    "success": true
}