文档
Start typing to search…

FuturePay 订单列表查询

该接口用于统一分页查询支付、退款、拒付、拒付预警订单列表

1.请求地址（POST）

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

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


2.请求参数（JSON 格式）

参数名类型必填说明
startDateString是开始时间（UTC 时间，格式：yyyy-MM-dd HH:mm:ss）
endDateString是结束时间（UTC 时间，格式：yyyy-MM-dd HH:mm:ss）
orderTypeString否订单类型，transaction-, refund-退款, rdr-RDR预警, ethoca-ETHOCA预警, efw-早期欺诈预警, chargeback-拒付, inquiry-拒付（查询）
pageSizeInteger否页宽，默认10
currentPageInteger否页码，默认1

示例：

{
    "startDate": "2026-02-12 00:00:00",
    "endDate": "2026-02-12 23:21:31",
    "currentPage": 1,
    "pageSize": 10,
    "orderType": "efw"
}

3.响应参数（JSON格式）

顶层字段

参数名类型示例值描述
codeString"0"响应码，0 表示成功
msgString"success"响应消息
serverTimeLong1770916097050服务器时间戳（毫秒，UTC）
successBooleantrue请求是否成功
dataObject见下表分页订单数据对象

data 字段

参数名类型示例值描述
currentPageInteger1当前页码（从 1 开始）
pageSizeInteger10每页条数
totalCountInteger2总记录数
totalPageInteger1总页数
hasMoreBooleanfalse是否还有更多数据
itemsArray见下表订单列表

items 字段（订单对象）

参数名类型示例值描述
merchantReferenceString"C4AD695A83234FBEBC2D6536B8474B3A"商户订单号
pspReferenceString"2021903193281265664"FuturePay 平台订单号
resultCodeString"SUCCEED"订单状态
failReasonString"RDR_WARNING"失败或预警原因
amountObject见下表支付金额信息
providerReferenceString"202500016422"支付渠道订单号
paymentMethodString"intercards"支付方式（如 cards、alipay 等）
completeTimeString"2026-02-12T11:04:15.000+00:00"完成时间（UTC）
orderCreateTimeString"2026-02-12T11:04:15.000+00:00"订单创建时间（UTC）
orderTypeString"rdr"订单类型（见下方枚举说明）

amount 字段

参数名类型示例值描述
currencyString"USD"币种代码
valueLong200支付金额，单位为“分

时间说明

所有时间字段均为 UTC 时间。
服务器时间戳（serverTime）为毫秒级 Unix 时间戳（UTC）。

orderType 枚举说明

值含义
transaction交易
refund退款
chargeback拒付
inquiry拒付查询
rdrRDR 早期欺诈预警
ethocaEthoca 预警
efwEFW 预警

resultCode 字段说明

resultCode 表示当前业务对象的处理状态，不同业务场景下其语义不同，需结合业务类型理解。

交易场景

值英文描述中文含义
INITIALIZEDTransaction initialization支付已创建 / 预支付
PENDINGTrade is pending processing支付处理中（如 3DS 认证、跳转或异步确认）
SUCCEEDTrade has been successful支付成功
FAILEDTrade is failed支付失败
NOT_CAPTUREDNot captured未完成捕获
AUTHORIZEDTrade has been authorized已授权

退款场景

值英文描述中文含义
SUCCEEDTrade has been successful退款成功
FAILEDTrade is failed退款失败
REFUND_PARTTrade has Partial refund successful部分退款成功

拒付场景

值英文描述中文含义
INITIALIZEDDispute has been initialized需要回应（查询）
PENDINGDispute is pending response需要回应
PENDING_REVIEWEvidence pending review证据待审核
UNDER_REVIEW_INQUIRYEvidence under review (inquiry)证据审核中（查询）
UNDER_REVIEWEvidence under review证据审核中
SUCCEEDDispute has been won by merchant争议胜诉（商户赢）
FAILEDDispute has been lost by merchant争议败诉（商户输）
CANCELDispute has been cancelled or closed争议已撤销 / 已关闭
EXPIREDDispute has expired争议已过期

示例：

{
    "code": "0",
    "msg": "success",
    "serverTime": 1770916097050,
    "data": {
        "currentPage": 1,
        "pageSize": 10,
        "totalCount": 1,
        "hasMore": false,
        "totalPage": null,
        "items": [
            {
                "merchantReference": "C4AD695A83234FBEBC2D6536B8474B3A",
                "pspReference": "2021903193281265664",
                "resultCode": null,
                "refusalReason": null,
                "failReason": "RDR_WARNING",
                "amount": {
                    "currency": "USD",
                    "value": 200
                },
                "currency": null,
                "providerReference": "202500016422",
                "paymentMethod": "intercards",
                "completeTime": null,
                "orderCreateTime": "2026-02-12T11:04:15.000+00:00",
                "orderType": "rdr"
            },
            {
                "merchantReference": "120447CBA56042348C235D9624DB73E4",
                "pspReference": "2021884830421221376",
                "resultCode": null,
                "refusalReason": null,
                "failReason": "RDR_WARNING",
                "amount": {
                    "currency": "USD",
                    "value": 200
                },
                "currency": null,
                "providerReference": "202502422432422",
                "paymentMethod": "intercards",
                "completeTime": null,
                "orderCreateTime": "2026-02-12T09:51:18.000+00:00",
                "orderType": "rdr"
            }
        ]
    },
    "success": true
}

Updated 1 day ago