法币提现发起（apply）
/payout/v1/fiat-withdraw/apply
发起法币提现（幂等键：mchOrderId）。需先通过 quote 获取 quoteId。
请求
请求头参数
content-type
string
REQUIRED
固定值：application/json
x-api-key
string
REQUIRED
Paydify提供，跟appId相同
x-api-timestamp
string
REQUIRED
时间戳，单位毫秒
x-api-signature
string
REQUIRED
签名，具体参看 签名算法
请求体
mchOrderId
string
REQUIRED
商户订单号（幂等键）
quoteId
string
REQUIRED
本次采用的报价会话ID
merchantId
string
提现单归属商户 ID（子商户）。合作伙伴（Partner）凭据代发时必填；商户自有凭据可不传，默认归属凭据所属商户。最长 64 字符
merchantAppId
string
归属商户下的应用 ID，用于归属商户存在多个已授权应用时消歧。凭据覆盖该商户多个应用时必填；仅一个授权应用时可不传，系统自动匹配。最长 64 字符
响应
响应体
code
string
响应码, SYS_SUCCESS表示成功
message
string
响应信息
messageDetail
string
详细响应信息
success
boolean
请求是否成功
data
object
withdrawOrderId
string
提现单号
mchOrderId
string
商户订单号
quoteId
string
报价会话ID
status
string
状态（通常为 PENDING）
arrivalAmount
string
到账金额
arrivalCurrency
string
到账币种（ISO 4217）
feeAmountFiat
string
法币口径手续费
chargeAmountFiat
string
法币口径总扣减价值
deductionSnapshot
object
deductionPlan
object[]
assetCode
string
扣减资产代码（如 USDC/USDT）
currency
string
兼容旧字段名，语义同 assetCode
deductAmount
string
当前资产实际扣减金额
principalAmount
string
当前资产中用于覆盖本金的金额
feeAmount
string
当前资产中分摊到的手续费金额
sequence
integer
扣减顺序（数值越小优先级越高）
bankAccountInfo
object
bankAccountId
string
银行账户唯一标识
beneficiaryBankBic
string
受益银行 BIC/SWIFT 代码
supportedCurrencies
string[]
账号支持的法币币种列表（ISO 4217）
beneficiaryAccountNumber
string
脱敏后的受益人银行账号
beneficiaryAccountNumberPlain
string
受益人银行账号明文；不可用或无权限时为 null
correspondentBankBic
string
代理行/中间行 BIC/SWIFT
beneficiaryAddress
string
受益人地址
beneficiaryBankAddress
string
受益银行地址
beneficiaryAccountName
string
受益人账户名称
beneficiaryBankName
string
受益银行名称
beneficiaryCountry
string
受益人国家
lockedRateSnapshot
string
锁定汇率展示快照（JSON 字符串）
rateSnapshot
object[]
fromCurrency
string
原币种
toCurrency
string
目标币种
rate
string
汇率（1 fromCurrency = rate toCurrency）
createdAt
string
创建时间（ISO 8601）；异步落库前可能为 null
1
RESPONSE
Click the Send API Request button above and see the response here!