Payment generator

VeilPay 支持两种支付方式：

直接方式是开始接受支付最简单的方法。您生成一个支付链接并发送给用户，用户打开链接完成交易。此方式无需后端集成。但由于交易参数（金额、地址等）有可能被用户修改，在交付商品或服务前，您应始终核实付款是否已到达正确地址。

间接方式让您对交易拥有更多控制权。在此流程中，您先创建交易并获得交易 ID，然后再向用户展示支付详情。由于交易是预先创建的，用户无法修改支付参数。这也让您可以使用交易 ID 追踪交易状态。使用此方式创建的交易必须在 72 小时内启动，否则将自动从数据库中移除。

如果您希望获得以下能力，请使用预生成交易方式：

对支付流程有更多控制权

能够追踪交易状态

更强的参数防篡改保护

如果您希望获得以下能力，请使用直接链接方式：

最快速的集成

无需后端开发

简单的支付链接流程

VeilPay 交易目前每笔限制为等值 5 BTC。

此限额有助于减少处理延迟，并降低潜在的 KYC 相关风险。

如果用户发送的加密货币与您选择接收的币种相同，则无需进行兑换。

Veil 对此类交易不收取任何费用。

如果在创建交易时启用了邮件通知，付款完成后您将收到通知。

VeilPay 不直接处理法币支付。

但是，您可以以法币（USD、EUR 等）设定交易价格。

VeilPay 会按当前汇率自动将该金额转换为等值的加密货币金额。

预生成（间接）方式专为服务器对服务器的集成而设计。您的后端通过我们的 REST API 创建一笔支付，获得一个 anonpay_id，然后按该 id 展示或嵌入 VeilPay 组件。所有支付参数都保存在我们这一端，因此客户无法修改金额、地址或其他任何字段。

所有接口都位于您 VeilPay 域名下的 /api/anonpay 路径中，均为公开接口——创建支付无需 API 密钥或签名。

从您的服务器向 /api/anonpay/prepare 发送 POST 请求，附上您希望接收的币种和网络、您的钱包地址以及金额。此时不会创建订单——您只是预留了一个支付意图。

将客户重定向到该 id 对应的支付页面，或将其以 iframe 形式嵌入您自己的页面。组件打开时金额和地址已锁定——客户只需选择使用哪种币种支付。

您可以随时通过 GET 请求查询当前状态。状态会依次经历 prepared → waiting_deposit → deposit_received → exchanging → sending → completed。

除了轮询，您也可以在创建支付时提供一个 webhook URL，以便在每次状态变化时接收 POST 通知：