跳转到主要内容
简而言之
Blockradar Checkout 让您可以通过可分享的链接接收稳定币付款,无需客户账户或复杂的集成。创建链接,分享它,然后直接在您的 wallet 中收款。

前置条件

在创建支付链接之前,请确保您具备:
1

API 密钥

从 Blockradar Dashboard 获取您的 API 密钥。前往 Developers 生成密钥。
2

已创建 Master Wallet

在 dashboard 中(参见创建主钱包)创建一个 master wallet。支付链接绑定到 wallet。
3

Checkout 计划已激活

确保您的账户中已启用 Checkout 功能。如需激活,请联系 [email protected]。
4

已配置 Webhook(可选)

设置 webhooks 以接收实时支付通知。请参阅 Webhooks 了解配置详情。

简介

支付链接是一种可分享的 URL,允许任何人向您的 wallet 发送稳定币付款。它们非常适合:
  • 电子商务:发送给客户用于产品购买
  • 开具发票:包含在为提供的服务开具的发票中
  • 捐赠:在社交媒体或网站上分享
  • 市场支付:促进点对点交易
  • 订阅计费:定期收款

支付链接的工作原理

创建

使用特定参数(如金额、名称、描述和支付限制)创建支付链接。

分享

通过电子邮件、即时消息将生成的 URL 分享给客户,或将其嵌入您的网站。

支付

客户点击链接,输入支付详情,并完成交易。

确认

您将收到 webhook 通知,并可以实时跟踪支付状态。

支付链接功能

  • 可自定义参数:设置金额、描述、支付限制和 metadata
  • 可分享的 URL:为每笔交易生成唯一的支付链接
  • 客户预填充:通过 URL query 参数预填充客户详情
  • 实时跟踪:监控支付状态并接收 webhook 通知
  • 多网络支持:在不同的区块链网络上接收付款
  • Auto-sweep 集成:资金自动归集到 master wallet

多资产支持

  • 跨多个区块链支持 USDT、USDC、DAI、BUSD
  • Ethereum、BSC、Polygon、Base、Arbitrum、Optimism、Tron、Solana、Celo
  • 自动转换和路由,提供最佳的用户体验

灵活配置

  • 针对特定产品/服务的固定金额
  • 针对捐赠或自定义支付的可变金额
  • 支付限制以确保按时支付
  • 自定义 metadata 用于跟踪和分析
  • Webhook 通知用于实时更新

安全与合规

  • 对所有入金支付进行 AML 筛查
  • 地址验证与核实
  • 欺诈检测与防范
  • 跨司法管辖区的监管合规

支付流程

1. 支付链接的创建

当您创建支付链接时,Blockradar 会返回一个唯一的支付 URL:

2. 通过 Query 参数预填充客户信息

您可以使用 query 参数增强支付 URL,以便在支付页面上自动预填充客户详情:
支持的可选 Query 参数:
  • name - 客户姓名(显示在支付页面上)
  • email - 客户的电子邮件地址
  • reference - 自定义引用,将包含在交易响应中
  • amount - 在支付页面上向客户显示的金额。该参数仅用于显示:Blockradar 不会存储它,也不会据此校验付款(参见实际到账金额不一致时)
  • redirectUrl - 支付完成后重定向到的 URL

3. 支付后重定向

提供 redirectUrl 时,客户将在支付处理完成后自动重定向到您指定的 URL。重定向 URL 将包含以下 query 参数: 重定向 Query 参数:
  • status - 支付状态(success、failed、pending)
  • tx_reference - 交易引用 ID
  • reference - 您的自定义引用(如果已提供)
  • slug - 支付链接标识符
重定向 URL 示例:
重定向仅在支付处理完成后发生。如果未提供 redirectUrl,客户将看到默认的支付完成 页面。

4. 金额配置

支付链接支持两种金额模式: 固定金额(预设)
  • 当您在创建时指定 amount,客户无法修改支付金额
  • 适合具有设定价格的特定产品或服务
  • 示例:以恰好 99.99 美元购买产品
可变金额(客户输入)
  • 当未指定 amount 时,客户可以输入自己的支付金额
  • 适合捐赠、小费或灵活定价场景
  • 客户在支付页面上看到金额输入字段
只有链接自身的 amount 决定 Blockradar 预期收到的金额。amount 查询参数只改变支付页面显示的内容,不改变 Blockradar 的校验依据。

5. 支付处理

客户访问支付链接,查看预填充的详细信息,并使用其首选的稳定币完成交易。

6. 交易响应

URL 中的 reference 参数将包含在交易响应和 webhook payload 中,使您能够将支付与内部系统关联起来。

实际到账金额不一致时

客户从自己的钱包或交易所发送稳定币,因此到账金额可能与支付页面上显示的金额不同。客户可能输入了别的数字,交易所也可能从发送金额中扣除提现手续费。Blockradar 如何记录这笔付款,取决于链接是否设置了固定金额。 在每个 payload 中,amountPaid 都是客户迄今实际发送的金额。在固定金额链接上,amount 是链接金额换算成所付代币、并按该代币的小数位数向下取整后的金额,因此多付 100.50 时,payload 中为 amount: "100" 和 amountPaid: "100.5"。在无金额链接上,amount 和 amountPaid 都是实际到账金额。
请根据 amountPaid 为客户入账,切勿根据您请求的金额入账。 在无金额链接上,被要求支付 100.00 的客户如果只发送了 95.00,仍会触发 deposit.success webhook,其中 amountPaid: "95"。按请求金额入账会让每一笔少付都被多记。

固定金额链接少付

低于链接金额的付款会被标记为 INCOMPLETE,并发送 deposit.incomplete webhook。任何差额都算在内,哪怕不足一美分。该 payload 与 deposit.success 的字段相同,amountPaid 为迄今收到的总额,metadata 中另有两个键:
  • remainingAmount:仍需支付的金额
  • partialPayments:每笔已收到的链上付款对应一条记录,包含其 hash、amount 和 senderAddress
示例仅展示该事件特有的字段。metadata 还会保留您在支付链接上设置的任何 metadata。 如果客户在该支付地址仍处于活跃状态时将剩余金额发送到同一地址,Blockradar 会将其累加到 amountPaid。如果某笔付款之后总额仍然不足,会再发送一个 deposit.incomplete。使总额达到链接金额的那笔付款会将交易变为 SUCCESS,并发送带有累计 amountPaid 的 deposit.success。所有事件都带有同一个交易 id。 不要指望每个 deposit.success 之前都有 deposit.incomplete。如果最后一笔付款到达时,之前的某个 deposit.incomplete 仍在重试中,该次投递会被丢弃,只发送 deposit.success。
按交易 id 入账,而不是按事件入账。 为每个 id 记录您已入账的累计金额。每收到一个 deposit.incomplete 或 deposit.success,入账 amountPaid 减去该累计金额的差额;如果结果为零或负数,则忽略该事件。这样可以正确处理部分付款、重试投递以及乱序到达的事件。如果您只为已完成的付款入账,请在收到 deposit.success 时处理,并使用 deposit.incomplete 告知客户还需支付多少。
要查看少付的付款,请使用 status=INCOMPLETE 列出链接的交易(参见获取支付链接的交易),并比较 amount 与 amountPaid。

为每位客户收取不同金额

如果每笔订单金额不同,请创建一个不设 amount 的支付链接,并在 URL 中传入每笔订单的金额和参考号:
客户会在支付页面上看到 99.99。无论客户发送多少,付款都会完成,您会收到带有该 reference 的 deposit.success。请在您的系统中将 amountPaid 与订单总额进行比较,并在那里决定如何处理少付或多付。

立即体验

通过我们的实时演示亲身体验 Blockradar 支付链接: 🔗 演示支付链接:https://pay.blockradar.co/demo 此演示展示:
  • 支付流程:从链接到完成的完整客户体验
  • UI/UX:现代化、直观的支付界面
  • 稳定币选项:多种支付方式和网络
  • 实时更新:实时交易状态和确认
演示支付链接仅用于测试目的。不会处理任何 真实交易。

创建支付链接

基本支付链接

为固定金额创建一个简单的支付链接:

可变金额支付链接

允许客户选择支付金额:

带文件上传的支付链接

使用 form-data 在支付链接中包含文件(例如发票、产品图片): Form-data 字段:
  • name:Service Invoice
  • description:Web development services - January 2024
  • amount:1500.00
  • redirectUrl:https://company.example.com/payment-success
  • successMessage:Payment received! We’ll start working on your project.
  • metadata:invoice_id: INV-2024-001, service: web_development
  • file:[cover.png](文件上传)
包含文件上传时,请使用 form-data 而不是 JSON。文件将被 存储,并可通过支付链接访问。

支付链接参数

必需参数

可选参数

支付流程

客户体验

  1. 点击支付链接
    • 客户接收并点击支付链接
    • 链接打开一个安全的支付页面
  2. 选择支付方式
    • 从可用的稳定币中选择
    • 选择首选的区块链网络
    • 输入支付金额(如果是可变的)
  3. 完成支付
    • 客户确认交易详情
    • 支付在区块链上处理
    • 实时确认和状态更新
  4. 成功确认
    • 支付确认页面
    • 可选地重定向到您的网站
    • 收据和交易详情

商家体验

  1. 实时通知
    • 支付状态的 webhook 事件
    • 电子邮件通知(如果已配置)
    • Dashboard 更新
  2. 支付跟踪
    • 交易历史和状态
    • 支付分析和报告
    • 与您的系统集成

地址生命周期

为 checkout 链接生成的支付地址具有有限的生命周期:
  • 支付成功后:地址将立即停用,无法接收额外的付款
  • 24 小时不活动后:如果在 24 小时内没有向地址付款,则会自动停用
每个新的支付会话都会生成一个新地址。这可确保安全并防止地址重用。

Webhook 事件

收到付款时,支付链接会触发以下 webhook 事件:

Webhook Payload 示例

关键 Webhook 数据字段

Webhook payload 包含有关支付的全面信息:
Webhook payload 中的 reference 字段对应于您在支付 URL 中包含的 reference query 参数。这使您能够将支付追溯到您系统中 的特定订单、客户或内部引用。

最佳实践

安全性

  • 使用 HTTPS 共享所有支付链接
  • 监控 webhook 事件以发现可疑活动
  • 在 webhook 端点上实施 rate limiting

用户体验

  • 清晰描述支付的用途
  • 针对移动设备优化的支付页面
  • 尽可能提供多种支付选项

集成

  • 存储支付链接 ID 以进行跟踪
  • 使用 metadata 将支付与您的系统关联
  • 实施 webhook 重试逻辑以提高可靠性
  • 首先在沙箱环境中测试 webhooks

用例和示例

电子商务商店

服务发票

捐赠活动

订阅服务

这些示例使用了正确的 Blockradar 支付链接 API 参数。metadata 字段必须以 JSON 字符串形式在 form-data 中发送,并且支持上传 file 以添加额外内容。

测试与开发

沙箱环境

  • 使用 testnet 网络进行开发
  • 测试 webhook 的传递和处理
  • 端到端验证支付流程
  • 测试边缘情况和错误场景

Webhook 测试

  • 使用 webhook.site 等工具进行测试
  • 验证签名校验
  • 测试重试机制
  • 监控 webhook 传递率

Checkout 计划

Blockradar Checkout 是一个可编程的稳定币支付层,用于通过链接、嵌入式 QR 码和 WalletConnect 接收链上支付。资金直接结算到您的非托管 wallets 中,并内置对 swap、bridge 和资金路由的支持。

定价

每笔交易 0.75%

简单透明的定价,无月度订阅费用。

支持的稳定币

  • USDC、USDT、cNGN、IDRX、EUROC 等

多链支持

  • Ethereum、Polygon、Base、Solana、Tron、Celo 等

资金管理

  • Swap 和 Bridge:跨链转换和移动资产
  • 自动结算:自动结算为您的首选货币
  • Circle Gateway:访问 Circle 的跨链转账协议
  • Auto-sweeping:将资金归集到您的 master wallet
此计划不包括 Wallet-as-a-Service (WaaS) 功能,也不包括为您的 最终用户提供专用 wallets。

获取支付链接的交易

您可以使用专用的交易端点检索与特定支付链接关联的所有交易。这对于以下场景很有用:
  • 支付跟踪:监控通过特定链接收到的所有付款
  • 对账:将支付与订单或发票匹配
  • 报告:为特定支付链接生成报告

Query 参数

响应示例

支持与资源

API 参考

获取帮助

Checkout 和支付链接是一种以最少的集成 工作量接收稳定币支付的强大方式。从简单的用例开始,随着您 对系统更加熟悉,逐步增加复杂性。