查询订单列表
/payout/v1/fiat-withdraw/list
查询法币提现订单列表(支持按订单号、状态、时间范围分页查询)。
请求
请求头参数
content-type
string
REQUIRED
固定值:application/json
x-api-key
string
REQUIRED
Paydify提供,跟appId相同
x-api-timestamp
string
REQUIRED
时间戳,单位毫秒
x-api-signature
string
REQUIRED
签名,具体参看 签名算法
请求体
withdrawOrderId
string
提现单号过滤
mchOrderId
string
商户订单号过滤
status
string
状态过滤(如 PENDING/PROCESSING/COMPLETED/CANCELLED/REJECTED/FAILED)
startTime
string
开始时间(ISO 8601)
endTime
string
结束时间(ISO 8601)
pageNo
int
页码(≥1,默认 1)
pageSize
int
每页条数(1-100,默认 20)
merchantId
string
提现单归属商户 ID(子商户)。合作伙伴(Partner)凭据代发时必填;商户自有凭据可不传,默认归属凭据所属商户。
merchantAppId
string
归属商户下的应用 ID,用于归属商户存在多个已授权应用时消歧。凭据覆盖该商户多个应用时必填;仅一个授权应用时可不传,系统自动匹配。
响应
响应体
code
string
响应码,SYS_SUCCESS 表示成功
message
string
响应信息
messageDetail
string
详细响应信息
success
boolean
请求是否成功
data
object
pageInfo
object
currentPage
integer
当前页码
pageSize
integer
每页条数
totalPages
integer
总页数
totalCount
string
总记录数(部分实现为数字字符串)
hasNext
boolean
是否有下一页
hasPrevious
boolean
是否有上一页
list
object[]
withdrawOrderId
string
提现单号
status
string
状态
quoteMode
string
报价模式
feeAmountFiat
string
法币口径手续费
chargeAmountFiat
string
法币口径总扣减价值
deductionSnapshot
object
deductionPlan
object[]
assetCode
string
扣减资产代码(如 USDC/USDT)
currency
string
兼容字段,含义同 assetCode
deductAmount
string
该资产实际扣减数量
principalAmount
string
本金部分
feeAmount
string
手续费部分
sequence
integer
扣减优先级,数字越小越优先
withdrawAmount
string
提现金额
withdrawCurrency
string
提现币种
arrivalAmount
string
到账金额
arrivalCurrency
string
到账币种
createdAt
string
创建时间(ISO 8601)
merchantId
string
提现单归属商户 ID(子商户)
1
RESPONSE
Click the Send API Request button above and see the response here!