Paydify Docs

法币提现报价预览

POST

/payout/v1/fiat-withdraw/quote

计价预览（无副作用）。根据到账币种/金额或扣减资产/金额，返回本次法币提现的报价会话与扣减计划等信息。

请求

请求头参数

content-type

string

REQUIRED

固定值：application/json

x-api-key

string

REQUIRED

Paydify提供，跟appId相同

x-api-timestamp

string

REQUIRED

时间戳，单位毫秒

x-api-signature

string

REQUIRED

签名，具体参看签名算法

请求体

quoteMode

string

REQUIRED

报价模式：ARRIVAL（输入到账金额）/ DEDUCT_ASSET（输入扣减稳定币金额）

bankAccountId

string

REQUIRED

目标银行账户ID

arrivalCurrency

string

REQUIRED

到账法币币种（ISO 4217，如 USD/EUR/HKD），支持的法币参看支持法币币种

arrivalAmount

string

模式 ARRIVAL：到账金额（币种=arrivalCurrency）

assetCode

string

模式 DEDUCT_ASSET：扣减资产代码（如 USDC/USDT），支持的稳定币参看支持的链和币种

deductAmount

string

模式 DEDUCT_ASSET：扣减金额

merchantId

string

询价归属商户 ID（子商户）。合作伙伴（Partner）凭据代发时必填；商户自有凭据可不传，默认归属凭据所属商户。

merchantAppId

string

归属商户下的应用 ID，用于归属商户存在多个已授权应用时消歧。凭据覆盖该商户多个应用时必填；仅一个授权应用时可不传，系统自动匹配。

响应

响应体

code

string

响应码, SYS_SUCCESS表示成功

message

string

响应信息

messageDetail

string

详细响应信息

success

boolean

请求是否成功

data

object

quoteId

string

报价会话ID

quoteMode

string

报价模式

expireAt

string

报价失效时间（ISO 8601）

bankAccountId

string

目标银行账户ID

bankAccountInfo

object

bankAccountId

string

银行账户ID

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

受益人国家

arrivalAmount

string

到账金额（法币口径，币种=arrivalCurrency）

arrivalCurrency

string

到账法币币种（ISO 4217，如 USD/EUR/HKD），支持的法币参看支持法币币种

feeAmountFiat

string

法币口径手续费（币种=arrivalCurrency）

chargeAmountFiat

string

法币口径总扣减价值（币种=arrivalCurrency）

lockedRateSnapshot

string

锁定汇率展示快照（JSON 字符串）

rateSnapshot

object[]

fromCurrency

string

原币种

toCurrency

string

目标币种

rate

string

汇率：1 单位 fromCurrency 可兑换 rate 单位 toCurrency

deductionPlan

object[]

assetCode

string

模式 DEDUCT_ASSET：扣减资产代码（如 USDC/USDT），支持的稳定币参看支持的链和币种

currency

string

与 assetCode 一致的兼容字段

deductAmount

string

该资产实际扣减数量

principalAmount

string

该资产承担的本金部分

feeAmount

string

该资产承担的手续费部分

sequence

integer

扣减优先级，数字越小越优先

SHELL

JAVA

PYTHON

NODEJS

RESPONSE

Click the Send API Request button above and see the response here!