法币提现（Fiat Withdraw）

Paydify 法币提现 API 允许商户将加密资产（如 USDC/USDT）兑换为法币并提现到指定银行账户。

主要功能

• 报价预览：获取实时汇率、手续费和扣减计划，无副作用
• 发起提现：基于报价会话创建提现订单，支持幂等
• 订单查询：按订单号、状态、时间范围分页查询提现记录
• 订单详情：查询单笔提现订单的完整信息
• 取消提现：在订单未处理前取消提现，天然幂等

接入流程

典型的法币提现流程如下：

1. 报价预览

调用 POST /payout/v1/fiat-withdraw/quote 获取报价信息。支持两种报价模式：

• ARRIVAL：输入到账金额，系统计算需要扣减的加密资产数量
• DEDUCT_ASSET：输入扣减的加密资产金额，系统计算到账法币金额

返回的 quoteId 有时效性（见 expireAt 字段），需在有效期内使用。

2. 发起提现

调用 POST /payout/v1/fiat-withdraw/apply，传入：

• mchOrderId：商户订单号，作为幂等键，同一 mchOrderId 不会重复创建订单
• quoteId：报价预览返回的报价会话 ID

提现创建后状态为 PENDING，后续由系统异步处理。

3. 查询订单状态

• 列表查询：POST /payout/v1/fiat-withdraw/list，支持按状态、时间范围、订单号筛选，分页返回
• 详情查询：POST /payout/v1/fiat-withdraw/detail，通过 withdrawOrderId 或 mchOrderId 查询单笔订单详情

4. 取消提现

调用 POST /payout/v1/fiat-withdraw/cancel，传入 withdrawOrderId。仅 PENDING 状态的订单可取消。

订单状态说明

认证

所有法币提现接口使用与 Payin/Payout 相同的认证机制。详见签名算法。

API 接口