Skip to main content
简而言之
Blockradar 的法币提现 API 将受支持的稳定币转换为法币,并发放至银行账户、移动货币及其他本地渠道。v2 流程会发现某个通道可用的支付方式,返回一个描述每种方式所需内容的 schema,解析诸如收款人账户名等字段,然后报价并从 master wallet 或 child address 执行提现。
Blockradar 法币提现界面
v2 支付方式会返回一个 JSON Schema,描述您的应用必须收集的收款人和支付 详情。请参阅 动态表单 来渲染、验证、解析并提交这些 字段。v1 流程可在 v1 · Legacy 标签页中查看,但不再推荐使用。

前提条件

在使用法币提现之前,请确保您具备以下条件:
1

合规已批准

在控制台完成尽职调查流程:My Wallets → Settings → Compliance。合规要求和批准流程因地区而异,因此您只需完成您的产品所使用的本地渠道对应的项目。
2

API 密钥

Blockradar 控制台 获取您的 API 密钥。导航至 Developers 进行 生成。
3

已创建钱包

通过控制台创建钱包。您需要 walletId 来执行提现 操作。
4

Asset ID

使用 Get Supported Assets 获取受支持的法币资产。将 返回的 id 作为整个流程中的 assetId 使用。

工作原理

v2 流程以通道为驱动:您选择一个资产、货币和金额,然后 发现支持该通道的支付方式,并精确收集 每种方式所需的内容。

发现资产

获取支持提现的稳定币。

获取货币与汇率

列出受支持的发放货币并获取当前汇率。

列出支付方式

发现该资产、货币和金额可用的支付方式。

获取要求

检索描述该方式所需字段的 JSON Schema。

解析与报价

解析诸如账户名等字段,然后对费用和汇率进行报价。

执行

提交 paymentMethodData 以处理提现。

受支持的法币

货币因通道和提供商而异。请始终通过 Get Supported Currencies 获取实时列表,而不要将其硬编码。下表显示了每种受支持货币所覆盖的稳定币和 区块链:

Master Wallet 与 Child Address

法币提现在两个层级提供:

Master Wallet

从 master wallet 提现。适合资金管理操作。

Child Address

从特定的 child address 提现。适用于面向用户的流程。

Endpoints

发现类端点(资产、货币、汇率、支付方式、要求、 解析)的作用域限定于 master wallet。一旦您拥有已验证的 paymentMethodData 对象,您就可以从 master wallet 或 child address 进行报价和执行。

典型流程

  1. 获取受支持的资产 以选择要提现的稳定币。
  2. 获取所选通道的货币和汇率
  3. 列出 该资产、货币和金额可用的 支付方式
  4. 获取 所选方式的 要求 以接收其 schema。
  5. 解析字段(例如账户名),然后 收集并验证 paymentMethodData
  6. 获取报价 以在执行前显示费用和汇率。
  7. 执行 提现并使用 webhooks 跟踪状态。

步骤 1:获取受支持的资产

获取可用于提现的稳定币,并将您想要的 id 作为 assetId

步骤 2:获取货币和汇率

列出受支持的发放货币,然后获取该资产、 货币和金额的当前汇率。
Rate Response

步骤 3:列出支付方式

发现该通道可用的支付方式。传入相同的 assetIdcurrencyamount;可选择通过 countrypaymentMethodCategory 进行缩小。
Payment Methods Response
supportsPaymentMethodResolution: true 表示该方式的 schema 可以包含一个 x-resolution 字段(例如账户名查询),您需要在报价前对其进行解析。请参阅 步骤 5

步骤 4:获取支付方式要求

获取描述所选 paymentMethod 所需字段的 JSON Schema。 使用 动态表单 来解释并完成它。
Requirements Response

步骤 5:解析字段并构建 paymentMethodData

收集 data.schema 中的字段。当某个字段带有 x-resolution(如 上面的 accountName)时,一旦其 dependsOn 字段有效,就调用解析端点, 然后将结果存储到该字段。
Resolve Response
解析并验证之后,您完成的 paymentMethodData 如下所示:

步骤 6:获取报价

请始终在执行前获取报价,以便向用户显示汇率、费用和 预计到账时间。发送已验证的 paymentMethodData
Quote Response

步骤 7:执行提现

用户接受报价后,使用相同的详情执行。添加可选的 reference 用于幂等性和跟踪,并根据需要添加 metadatanote

Execute Response

从 Child Address 提现

要从特定的 child address 发放资金,请使用相同的请求体对 地址作用域端点进行报价和执行:

Webhooks

通过以下 webhook 事件跟踪提现状态:

Webhook Payload 示例

有关 webhook 设置、payload 结构和事件处理,请参阅 Webhooks 文档

完整流程示例

一个完整的 v2 实现,展示了发现 → 要求 → 解析 → 报价 → 执行的流程:

错误响应

最佳实践

用户体验

  • 报价前先解析:在显示报价之前,通过解析端点确认收款人账户名。
  • 显示完整成本:展示汇率、交易费用、网络费用和 debitAmount
  • 呈现处理状态:使用 webhooks 实时更新用户。

正确性

  • 使用返回的 schema:仅收集当前要求 schema 中的字段。不要硬编码收款人字段——请参阅 动态表单
  • 保留字符串:将 amount 和账户标识符作为字符串发送,以避免精度损失。
  • 使用引用:使用唯一的 reference 跟踪提现,以便安全重试。
  • 通过 webhooks 确认:将 offramp.success 视为最终事实来源。

性能

  • 缓存资产和货币列表:定期刷新,而不是每次请求都获取。
  • 按通道重新获取汇率和方式:汇率和支付方式取决于资产、货币和金额。
  • 对瞬时错误进行重试:对 5xx 响应使用指数退避。

API 参考

v2(推荐)

支持