> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blockradar.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 客户法币流程

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

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

## 客户身份与会话

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

## 法币提现

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

```http theme={null}
GET /v2/wallets/{walletId}/withdraw/fiat/rates?assetId={assetId}&currency=USD&amount=100&amountSide=target&customerId={customerId}
```

## 付款方式解析

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

```json theme={null}
{
  "sessionId": "13a36c1c-f4a6-4e49-a582-2ecded2559bc",
  "paymentMethod": "provider-method-id",
  "paymentMethodData": {
    "AccountNumber": "0123456789"
  },
  "continuation": {
    "resolutionId": "provider-resolution-id",
    "stepId": "provider-next-step-id",
    "data": {
      "Acknowledgements": {
        "CoBName": true
      }
    }
  }
}
```

## 审核恢复

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

| HTTP | details.code | 操作 |
| - | - | - |
| 400 | `CUSTOMER_ONBOARDING_REQUIRED` | 完成或继续审核。 |
| 409 | `CUSTOMER_ONBOARDING_PENDING` | 等待或继续未完成的客户步骤。 |
| 403 | `CUSTOMER_ONBOARDING_REJECTED` | 显示拒绝状态，不要自动创建新案例。 |
| 409 | `CUSTOMER_PROVIDER_UNAVAILABLE` | 客户与服务商映射不可用；遵循返回的恢复操作。 |

## 法币充值

报价、要求解析和订单创建接受 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](https://docs.blockradar.co/zh/api-reference/customer-onboarding/webhooks.md)

[刷新客户审核](https://docs.blockradar.co/zh/api-reference/customer-onboarding/refresh-request.md) — 重新请求提现汇率或充值报价以创建新的法币会话。不要复用批准前创建的会话。状态变化也可能发出 customer.onboarding.\* webhooks；案例未变化时不保证产生新事件。

## 客户操作

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

* [更新申请](https://docs.blockradar.co/zh/api-reference/customer-onboarding/update-request.md)
* [标记托管步骤已提交](https://docs.blockradar.co/zh/api-reference/customer-onboarding/hosted-session-submission.md)
* [重新打开申请](https://docs.blockradar.co/zh/api-reference/customer-onboarding/reopen-request.md)
* [查看文件](https://docs.blockradar.co/zh/api-reference/customer-onboarding/document-view-urls.md)
* [提交操作](https://docs.blockradar.co/zh/api-reference/customer-onboarding/submit-action.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.