加密支付与卡支付的区别
如果您的团队之前集成过卡支付,一些习惯将无法延续。使用卡片时,商家向客户收费。而在加密支付中,客户从自己的钱包发送资金,您的系统必须对实际到账的金额做出反应。这改变了集成必须处理的内容。
金额可能与发票不同。客户可能会发送略少于或多于请求的金额,例如由于网络费用或汇率差异。请提前决定是否接受少付和多付。
例如,您可以接受小差异,联系客户或发放退款。无论您决定什么,都要在销售条款中说明,包括您的退款规则以及谁支付退款的网络费用。
网络很重要。同一代币存在于多个区块链上。通过错误的网络或发送到错误地址的资金可能会丢失。
报价会过期。如果您以相同货币结算,发票汇率有效期为60分钟;如果需要转换,则有效期为15分钟。迟付款的客户可能需要新的付款请求。
确认需要时间。资金仅在区块链确认付款后才会入账,因此您的界面和订单逻辑必须处理等待。
没有退款和自动撤销。已确认的链上交易无法取消。退款是根据您自己的政策和适用的消费者保护规则进行的单独支付。
结算是商业决策。一旦付款完成,资金将入账到您的Volet.com账户。您可以保留收到的加密货币或自动将其转换为稳定币或法币,以便财务可以在一种货币中进行对账并避免波动。
更多细节:Volet.com的商业账户费用
Volet.com 负责的事项
网络确认由您处理。 Volet.com 监控区块链,等待所需的确认并记入资金,因此您的后端无需跟踪区块或确认计数。
跨网络的稳定币余额。 在一个网络上收到的稳定币可以通过另一个支持的网络提取,而无需单独的跨链桥服务。
没有滚动储备。 Volet.com 不会将您已完成支付的一部分作为滚动储备扣留。
您对欠款和超额付款的规则。 在网关设置中,您决定是否接受低于或高于发票金额的付款。例如,如果客户向您充值余额,您可以准确记入到达的金额并接受欠款。对于超额付款,只有订单金额会记入您的账户。
处理逾期付款。 如果付款在发票过期后到达,Volet.com 会将其退还给客户,或者在某些情况下,将其记入您的账户。
资金进出。 相同的 Volet.com 余额可以用于您的支出付款:向承包商、创作者或合作伙伴的大额支付,或为您自己的用户提款。例如,交易所可以接受用户的加密存款,并通过 API 从相同的 Volet.com 余额处理他们的加密提款。
Volet.com 助您搭建全球支付
支持法币、加密货币与稳定币。通过 API、Hosted Checkout 或即装即用的插件接入。收款、付款、资金管理,全在代码中完成。
API或托管结账:实用比较
关键决策是您的产品需要拥有多少支付体验——以及您准备投入多少工程精力。
当您需要自己的支付UI并控制整个支付流程时,选择仅API。 您的应用程序拥有每一个面向客户的步骤,从显示支付说明到保持客户知情,直到支付被确认或过期。您的团队负责构建和维护所有这些。
Volet.com的指南:API集成
当自定义支付UI和对每个步骤的完全控制不是要求时,选择Hosted Checkout。 Volet.com托管支付页面,这通常是更简单、工作量更少的路径。它也可以在Telegram机器人和迷你应用中使用,支付页面在应用内浏览器窗口(webview)中打开。

这是Volet.com的托管结账页面可能的样子
阅读更多: Telegram迷你应用中的加密支付 — 设置指南、星级规则和实际费用
您还可以将托管结账与API结合使用,以进行订单查找和对账。无论哪种方式,托管结账仍然需要后端工作。您的应用程序保留自己的订单记录,并将其与Volet.com端的支付状态匹配。您的后端还会对发送到托管结账的请求进行签名,这有助于防止篡改请求,从而将客户的支付重定向到您的商店之外。
| 决策因素 | 仅API | 托管结账 |
|---|
| 面向客户的支付用户界面 | 由您的团队构建和维护 | 由Volet.com托管 |
| 对支付漏斗的控制 | 高:您的应用程序拥有体验 | 更有限:客户遵循托管流程 |
| 工程努力 | 更高:用户界面、状态检查、过期和边缘情况 | 对于支付用户界面较低;后端仍然对支付请求进行签名,处理通知并更新订单 |
| 最佳适配 | 在网站、应用、机器人或平台上的自定义结账 | 标准支付流程,其中重定向到托管页面是可以接受的,包括Telegram机器人和迷你应用 |
| 状态处理 | 后端通过API检查支付状态 | 状态URL通知加上API查找以进行必要的对账 |
| 来自Volet.com账户余额的支付 | 不可用:仅API接受来自外部钱包的加密货币 | 可用:客户可以从他们的Volet.com账户余额支付,费用为0.25% |
Volet.com 助您搭建全球支付
支持法币、加密货币与稳定币。通过 API、Hosted Checkout 或即装即用的插件接入。收款、付款、资金管理,全在代码中完成。
您的团队实际需要构建的内容
发票端点只是API-only实现的一部分。在承诺之前,请考虑以下产品和操作责任。
API-only的流程是如何工作的:
- 在您的系统中创建订单。
- 通过API创建加密发票。
- 向客户显示API返回的地址、金额、货币、网络和到期时间。
- 客户从他们的钱包发送付款。
- 您的后端通过API检查付款状态。
- 一旦付款确认,标记订单为已付款并完成。
使用Hosted Checkout和API的流程是如何工作的:
- 在您的系统中创建订单,并将客户重定向到带有您的orderId的Hosted Checkout。
- 客户在Hosted Checkout页面上付款。
- Volet.com向您的状态URL发送通知,这是您服务器上接收付款更新的端点。
- 您的后端验证签名,并在需要时通过API确认订单。
- 标记订单为已付款并完成。
支付UI和发票生命周期。您的应用程序必须准确显示API返回的支付详情:发送的金额、货币、区块链网络、地址、任何目的地标签或备注,以及到期时间。应警告客户仅通过指定网络发送资金。错误的支付指令可能导致资金损失,因此这是一个功能要求,而不是视觉细节。
在付款状态确认之前,不要告诉客户付款已失败或完成。
后端订单和支付模型。将您的内部订单与支付尝试或发票分开。这使得处理放弃结账、过期发票、客户重试以及在用户离开页面后到达的状态更新变得更容易。
为每个支付尝试使用唯一的orderId,如API文档所述。在您自己的数据库中定义每个尝试如何映射到订单。与每个订单一起存储Volet.com交易ID、收到的金额和结算货币,以便财务可以将每笔付款与发票匹配,而无需手动电子表格。加密收据的税务处理取决于您的管辖权,因此请与您的会计师达成一致。
选择发票金额模型。决定订单是以您期望收到的货币定价,还是客户应发送特定加密货币的固定金额。这个选择会影响价格显示、对账以及您如何解释应付金额。将其与您的定价和会计模型对齐,并在创建实时发票之前验证计算值。API文档解释了如何设置每个选项。
Volet.com的指南:API集成
假设您的客户下了一个120欧元的订单并以加密货币支付。您的后端应该保留足够的信息,以将完成的支付与原始订单匹配。对于这笔支付,它将存储:
- 您的订单ID (ORD-10482) 在您的系统中标识该购买。
- Volet.com交易ID (VLT-839201) 将支付与Volet.com侧的交易链接。
- 收到的金额 (约139 USDT) 显示客户实际发送的金额。
- 结算货币 (EUR) 记录您的财务团队所使用的货币。
- 支付状态 (最终,由API确认) 告诉您支付是否可以视为完成。
要进行对账,将Volet.com交易与您的支付尝试和订单匹配,然后比较交易ID、预期和实际金额、货币及最终支付状态。如果支付缺失、延迟或与预期金额不符,请标记以供调查,而不是自动将订单标记为已支付。
客户创建一个订单,打开支付页面并发送所需的加密货币。在区块链确认交易之前,他们关闭了浏览器标签并离开了您的网站。
您的后端继续跟踪支付:
- 客户的订单在您的系统中保持 待处理 状态。
- 支付尝试独立继续。使用仅API时,您的后端通过API检查其状态。使用托管结账时,Volet.com会向您的状态URL发送通知。
- 您的后端通过API验证支付状态。
- 一旦支付被确认完成,您的系统将订单标记为已支付并触发履行。
- 如果客户返回到您的网站,他们会看到更新的订单状态。
重要的一点:关闭结账页面并不会取消支付或确认支付。您的后端,而不是浏览器重定向,决定何时可以履行订单。
状态处理和恢复。 仅使用API时,您的团队需要选择一个轮询策略(后端检查状态的频率),避免不必要的请求,并处理临时查找失败,而不会错误地更改订单状态。
将通知视为信号,而不是付款证明:在履行之前验证其签名并通过API查找订单。每个订单处理一次,以您自己的orderId为键,因此重复的通知或第二次状态检查不能重复履行。
仅在API确认付款完成后才履行订单,而不是在发票创建成功或浏览器重定向时。确切的状态值及如何处理每个状态在API文档中有描述。
Volet.com的指南:API集成
即使远程系统已处理请求,请求也可能会超时。在模糊失败后不要盲目重试发票创建。在决定下一步之前,记录API的errorId,检查现有订单和付款状态,并遵循文档中的错误处理。绝不要自动创建重复订单,只有在安全的情况下才重试请求。
安全性和操作准备。 将API密钥和身份验证凭据保存在服务器上。绝不要在前端代码、移动应用、机器人或客户端脚本中暴露它们。仅配置集成所需的权限,并限制API访问到您服务器的IP地址:在生产环境中不建议允许所有IP。
设计可靠的支付流程
支付流程必须处理的不仅仅是成功的情况。
决定产品在以下情况下应如何处理:
- 发票创建超时且结果未知;
- 状态查找暂时失败;
- 发票在客户付款之前过期;
- 客户放弃结账并稍后返回;
- 客户开始另一次付款尝试;
- 状态通知延迟或收到多次。
目标是避免重复履行,保持内部订单状态一致,并给客户明确的下一步。
Volet.com的指南:API指南,包含确切的状态定义和响应字段
没有沙盒的测试
Volet.com没有沙盒或测试环境。请提前规划,而不是在启动时发现这一点:
- 请求Volet.com销售团队的现场演示,以查看支付流程、API和托管结账,然后再进行构建。
- 尽早创建网关。新的托管网关(Volet.com在您的账户上持有收到的资金的网关)需要经过合规审查,通常需要几个小时,您可以在此期间完成集成。
- 在生产环境中使用真实支付进行测试:成功、失败、过期、少付和多付。每个加密测试支付都是带有网络费用的真实链上交易。
- 对于托管结账,还要检查状态URL的交付、签名验证以及成功和失败的重定向。
- 在您的数据库中标记测试订单,以便在对账时不与真实收入混合。
现实地估算工作量
实际工作量取决于您现有的结账架构、所需的用户体验、工程师对支付API的经验以及测试(QA)的范围。
| 工作流 | 仅API | 托管结账 |
|---|
| 账户和网关设置 | 账户验证、API配置、权限和批准 | 账户验证、托管结账配置和任何所需的批准 |
| 核心实现 | 发票创建、支付UI、状态检查和订单更新 | 重定向流程、状态URL处理和后端订单更新 |
| 边缘案例 | 过期、模糊的超时、重试、重复尝试和网络指令 | 通知验证、重定向边缘案例和对账 |
| 质量保证 | 支付详情显示、状态检查、过期、失败和恢复 | 重定向、通知传递、签名验证和对账 |
| 持续的所有权 | 用户界面维护、监控、支持诊断和状态处理 | 后端监控、订单对账和回调操作 |
分别估算成功路径和失败路径,并包括端到端测试和生产监控的时间。
Volet.com 的费用
稳定币和加密支付的费用从 0.25% 开始。美元(USD)、泰达币(USDT)和美元硬币(USDC)之间的转换按固定的 1:1 汇率进行;其他转换另行定价。客户支付区块链网络费用。没有设置费用和月费。您可以选择谁来支付处理费用。高交易量可能通过销售获得定制定价。
在全球收取 USDT、USDC 及主流加密货币
从加密支付网关开始——即时结算,手续费低至 0.25%
常见问题
不。Volet.com没有测试环境。您可以向销售团队请求现场演示。在上线之前,测试成功、失败、过期、少付和多付。
新的托管网关首先需要经过合规审查。通常需要几个小时。在创建网关之前,您的账户必须经过验证。利用等待时间完成集成。
不。仅使用API时,您的后端自行检查支付状态。如果您需要通知,请将托管结账与API一起使用。
您的网关设置决定是否接受少付和多付。如果支付在发票过期后到达,Volet.com会将其退还给客户,或者在某些情况下,将其记入您的账户。仍然想支付的客户可能需要新的支付请求。
在回复之前,通过API根据您的orderId查找订单。
转账可能在链上可见,但仍然与发票不匹配:可能是短款、迟到或通过其他网络发送。
为您的支持团队提供支付详情的访问权限,并提前达成一致,何时将案件升级到Volet.com支持。
不。确认的链上交易无法取消,并且没有卡网络的退款。退款是根据您自己的政策和适用的消费者保护规则进行的单独支付。
不。Volet.com不提供卡收单服务。请保留您的卡收单服务用于直接卡支付。