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

客户身份与会话

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

法币提现

请从获取汇率开始提现,仅在付款属于客户时提供 customerId。后续步骤通过 sessionId 继承客户。更换客户需要新建会话。企业集成必须保持符合条件。

付款方式解析

当 status 为 requires_action 时,请展示 nextStep.schema,并提交 continuation,其中包含返回的 resolutionId、作为 stepId 的 nextStep.id 以及所需数据。重复此流程,直到 status 为 resolved。 对于将完整解析结果保存在提现会话中的支付方式,后端会为每种方式保留最新的表单和解析结果。报价和执行仅需 sessionId 与 paymentMethod;无需重新发送表单或解析结果。收款人信息变更后,请重新解析。完成解析不能替代获取报价:执行前仍需请求并核对报价。

审核恢复

客户资格失败使用 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。