跳转到主要内容
使用现有客户身份发起法币提现、付款订单和虚拟账户操作。客户必须处于活跃状态且属于已认证企业。省略 customerId 时使用企业身份流程；客户审核不能启用尚未配置的企业集成。

​
客户身份与会话

提现从 rates 请求开始传入 customerId，充值从报价请求开始传入 customerId。后续请求传入 sessionId，服务器会继承客户身份。重复传入的 customerId 必须相同。变更客户、路由、网络或路由参数时必须新建会话。资产、币种和充值渠道发现接口不接受 customerId。

​
法币提现

汇率、付款方式、要求、解析、报价和执行请求均接受可选 customerId，子地址报价和执行也支持。旧版 v1 提现接口在 DTO 包含客户上下文时同样接受该字段。当前支持客户身份的适配器包括 Noah 和 Infinia；API 不会静默使用企业身份替代客户身份。

​
付款方式解析

解析返回 status: requires_action 时，展示 nextStep.schema，并向同一接口提交包含 resolutionId、stepId 和 data 的 continuation。保留原始 paymentMethodData。继续至 resolved，再将完整响应作为 resolvedPaymentMethod 传入报价和执行请求。旧版响应若没有 status 或 nextStep，则视为已解析。

​
审核恢复

客户资格失败使用 HTTP 错误响应，而非成功 data 响应。请检查 details.code、details.customerId、details.provider 和 details.onboarding.action，并遵循返回的方法、路径和请求体。create_case 使用现有客户；resume_case 查询案例；wait 等待；contact_support 联系支持。不要因待审核或已拒绝案例自动新建客户或案例。

​
法币充值

报价、要求解析和订单创建接受 customerId。存在 sessionId 时继承 assetId、currency、amount 和 rail；否则必须提供这些字段。customer 是可选付款人联系方式，不能替代 customerId。内联 KYC 使用 additionalDataRequirements.data 作为默认值，按当前 schema 验证后再提交 additionalData。托管审核另行检查。

​
虚拟账户

v2 要求、创建和重新生成已支持 customerId，子地址创建和重新生成也支持。要求接口验证客户归属及服务商资格。请使用 additionalDataSchema，不要复用订单 schema。新建账户返回 201 和 created: true；复用已有账户返回 200 和 created: false。

​
报价金额与费用

debitAmount 是源资产总扣款。amountFiat 是扣除 deductions 前的法币付款金额；减去一次 deductions 即为收款人到账金额。transactionFee 以源加密资产计价，可包含额外独立收费、完整付款方式费用及处理费。它不一定是全部客户费用：服务商已收费用可能包含在资金估算内，点差已计入汇率。不要再次将费用加到 debitAmount。响应没有 transactionFeeCurrency 字段。

​
另请参阅

客户审核 Webhooks 刷新客户审核 — 重新请求提现汇率或充值报价以创建新的法币会话。不要复用批准前创建的会话。状态变化也可能发出 customer.onboarding.* webhooks；案例未变化时不保证产生新事件。

​
客户操作

客户 ID 和案例 ID 均为必填。更新后的案例位于 data.case。