加密支付 API：逐步与 OxaPay 集成

加密支付 API 可帮助您更轻松地接收加密货币，处理钱包设置、付款追踪和交易确认。它可将复杂的区块链流程简化为网站、应用或后端系统的流畅体验。本指南将逐步向您展示如何集成 OxaPay 的加密支付 API，让您轻松 接受加密货币支付 无论您是开发人员还是经营在线业务。

什么是加密支付 API？

加密货币支付 API 是一套工具，可让您的网站、应用或后端系统更轻松地接受和管理加密货币支付。您无需手动创建钱包地址、等待区块链确认或自行查看支付状态，该 API 会处理所有事务，包括生成发票、跟踪付款并实时更新订单状态。.

可以把它想象成一个专为加密货币打造的数字收银机。您向其发送金额和订单详情，它会为您的客户提供一个专属的钱包地址或支付链接。付款完成后，API 会立即通知您的系统，无需手动操作，也不会产生技术问题。.

关于加密支付 API 的常见问题

💬 我需要知道如何编写代码才能使用加密支付 API 吗？

是的，如果您计划将其直接集成到自定义网站或应用程序中，则需要一些基本的编程技能，通常使用 JavaScript、Python 或 PHP。但是，如果您使用 WooCommerce 或 WordPress 之类的平台，许多提供商（包括 OxaPay）都提供无需任何编码的即用型插件。.

💬 我可以通过一次集成接受多种加密货币吗？

当然。一个好的加密货币支付 API 可以让您通过单一、统一的设置接受多种加密货币，例如 BTC、ETH、USDT（TRC-20、ERC-20 等）以及其他货币。这样可以节省时间，提高您的支付流程效率。.

💬 使用 API 进行加密支付的速度有多快？

该 API 会在付款出现在区块链上时立即检测到。大多数 API（例如 OxaPay 的 API）会通过 Webhook 发送即时状态更新，因此您的系统会在几秒钟内收到通知，无需手动刷新或检查。.

💬 通过 API 接受加密安全吗？

是的，只要遵循最佳实践即可。这包括使用 HTTPS、保护您的 API 密钥、检查 Webhook 数据以及选择性地限制允许的 IP 地址。OxaPay 支持所有这些操作。

💬 我可以在接受实际付款之前测试系统吗？

是的。OxaPay 提供沙盒模式，可模拟完整的支付流程，非常适合测试，且无需冒着使用真实加密货币的风险。.

💬 我如何向我的客户显示付款请求？

大多数加密货币支付 API 在创建发票后都会返回支付链接或钱包地址。例如，您可以直接在结账页面上显示地址，或者将客户重定向到安全托管的支付页面。OxaPay 支持这两种支付方式，您可以选择最适合您设计和用户体验的方式。

💬 我如何追踪付款状态？

这些 API 通常通过 Webhook 发送状态更新。付款完成后，系统会向您的后端发送一条实时消息，显示付款状态，例如“已付款”、“确认中”或“已过期”。这使您的平台能够自动更新订单，无需任何手动操作。.

OxaPay 的加密支付 API 为何脱颖而出

A good Crypto Payment API should be easy to implement, secure by default, and flexible enough to support different business models. OxaPay delivers on all three. Its API is simple, clearly documented, and designed for fast integration, making it ideal for developers and growing businesses. With built-in webhook support, strong security practices, and real-time response updates, it helps teams launch crypto payments with minimal complexity.

OxaPay API 的主要优势：

• 清晰易懂的指南，可快速完成设置
• 稳定、明确定义的 API 路径，以确保长期可靠性
• 一致的 JSON 响应，易于解析和集成
• 内置错误处理和状态代码，可顺利进行调试
• 高可用性、快速响应时间和低延迟
• 具有 API 密钥认证和 IP 允许列表的安全架构

OxaPay 加密支付 API：集成指南

1. 创建您的 OxaPay 帐户并获取 API 密钥

在集成 API 之前，您需要在 OxaPay.com 并生成您的 API 密钥。此密钥用于将您的系统安全地连接到 OxaPay。

以下是如何开始：

1. 在 OxaPay 上注册
   进入主页，点击“注册”。你可以使用邮箱、谷歌账户，甚至是Telegram账号进行注册。
2. 访问商户 API 部分
   登录后，转到仪表板并单击 商户应用程序接口 在侧边栏中。
3. 生成您的 API 密钥
   点击“生成 API 密钥”按钮。系统会要求您选择要接受的加密货币。您还可以配置：
   • 保险费用不足 （例如，接受小额少付款）
   • 谁支付网络费用 （您或客户）
4. 复制并安全存储您的 API 密钥
   这个钥匙就像一个密码，, 永远不要公开分享 并避免将其直接硬编码到前端代码中。

📌 笔记： 如果您需要为不同的服务进行不同的设置（例如，一个用于您的网站，一个用于移动应用程序），则可以生成多个密钥。

一旦您的 API 密钥准备就绪，您就可以开始进行经过身份验证的 API 调用来创建付款发票。

2. 配置 API 设置并选择支持的货币

在开始创建发票之前，务必根据您的业务需求配置 API 设置。OxaPay 让您完全控制系统如何处理每个付款请求。

您可以配置以下内容：

1. 选择支持的货币

在 OxaPay 后台，前往“商户 API”>“设置”，然后选择您想要接受的加密货币。您可以启用 BTC、ETH、USDT（TRC-20、ERC-20、BEP-20）、USDC、DAI 等热门货币。

📌 提示：您可以随时更改此列表，而无需生成新的 API 密钥。

2. 设置少付保险

定义您愿意接受的小额欠款金额（例如，5%、10%，最高可达 60%）。这有助于避免因小额转账差额或手动输入错误导致交易失败。

3. 明确费用责任

选择由您（商家）还是客户（付款人）承担区块链网络费用。这将直接影响客户在支付页面上看到的内容。

4. 设置发票有效期

确定发票的有效期，通常为 10、30 或 60 分钟。一旦超过有效期，付款链接将失效，除非重新激活。.

对于开发人员：

这些设置是默认使用的，但您可以根据需要为每张发票更改它们。

开发人员可选：

您可以通过在 API 请求 JSON 中包含参数来覆盖默认仪表板设置，如下所示。

{ “amount”：49.99，“currency”："USDT"，“lifeTime”：30，“underPaidCover”：10，“feePaidByPayer”：true}

这允许您根据请求自定义发票行为，而无需更改全局 API 配置。

生成付款发票（createInvoice 端点）

配置 API 设置后，下一步是使用 创建发票 端点。然后，此端点会创建一个唯一的支付链接或钱包地址，您的客户可以使用它来安全付款。

🔧 技术说明（针对开发人员）

createInvoice 端点接受几个参数：

必需参数：

• 商家 – 您的 API 密钥
• 金额 – 付款总额

可选参数：

• 货币 – 您想要接收的加密货币（例如“USDT”）
• orderId – 您自己的内部订单参考
• callbackUrl – OxaPay 应该用来通知您的系统付款状态的 URL
• 描述 – 发票上显示的描述
• lifeTime – 发票到期前的时间限制（以分钟为单位）
• feePaidByPayer – 谁支付区块链费用
• underPaidCover – 允许的少付保证金
• returnUrl – 付款后重定向目的地

Python 示例（请求）

导入请求有效负载 = { “商家”：“YOUR_API_KEY”， “金额”：“49.99”， “货币”：“USDT”， “订单号”：“ORDER-1234”， “描述”：“每月订阅”， “回调网址”：“https://yourdomain.com/webhook”， “返回网址”：“https://yourdomain.com/thank-you” } 响应 = 请求。post（“https://api.oxapay.com/merchant/invoice”，json=payload） 打印（response.json（））

此代码将您的订单信息发送到 OxaPay，并接收您的付款链接 顾客可以使用。

JavaScript 示例（获取）

fetch("https://api.oxapay.com/merchant/invoice", { method: "POST", headers: { "Content-Type": "application/json" }, body: JSON.stringify({ merchant: "YOUR_API_KEY", amount: 49.99, currency: "USDT", orderId: "ORDER-1234", description: "月度订阅", callbackUrl: "https://yourdomain.com/webhook", returnUrl: "https://yourdomain.com/thank-you" }) }) .then(res => res.json()) .then(data => console.log(data));

简单解释

即使您不是程序员也不用担心。此步骤用于告知 OxaPay 客户需要支付多少金额以及支付哪些款项。请求发送后，OxaPay 会生成一个安全的支付链接，您的客户可以使用该链接完成交易。此链接对于每个订单都是唯一的，并确保自动跟踪和确认付款。

您可以将其想象成将账单的详细信息发送给助理，他们会立即为您的客户创建一个付款页面，其中包含跟踪、安全和到期信息。.

使用 WordPress 或 WooCommerce 之类的平台？

如果您使用 WordPress 或 WooCommerce 等平台，则无需编写任何代码。OxaPay 提供现成的插件，可自动处理发票生成。当客户下单时，该插件会创建发票、显示付款链接并跟踪付款，所有这些都无需您接触 API。.

显示付款链接或钱包地址

使用 API 创建发票后，OxaPay 会返回一个付款链接。此链接会将客户带到一个安全页面，客户可以使用自己选择的加密货币完成付款。

您可以将此链接显示为结账页面上的按钮，例如“使用加密货币支付”，也可以在用户下单后立即将其重定向到该链接。此页面由 OxaPay 托管，适用于所有设备，并实时更新。.

或者，如果您想要更多的控制，您可以使用 支付链接 从响应中获取信息并决定如何显示。例如，您可以使用 JavaScript 重定向用户。

窗口.位置.href = 响应.payLink;

除了付款链接外，您还将收到 轨道编号, ，每张发票的唯一标识符。此值可以保存在您的数据库中，以便您以后将付款更新与正确的客户订单进行匹配。尤其是在使用 Webhook 时，这可以确保您的系统始终知道哪笔付款属于哪个订单。.

此外，您无需设计或托管自己的支付界面。OxaPay 已提供全面优化的支付页面，可在所有设备上流畅运行。得益于其简洁、快速且移动友好的设计，您只需连接、显示链接，剩下的交给平台处理即可。

使用 Webhook 处理实时支付状态

一旦客户付款，您的系统需要立即自动获知。OxaPay 通过 Webhook 解决了这个问题，它会将实时付款状态更新发送到您在创建发票时指定的 URL。.

这意味着无需人工核对。一旦检测到或确认付款，OxaPay 会向您指定的回调 URL 发送安全的 HTTP POST 请求，其中包含付款状态、轨迹 ID、金额和货币等关键信息。

您可能会收到以下内容：

{ "trackId": "abc123", "status": "已付款", "amount": "49.99", "currency": "USDT" }

常见的状态值包括：

• 等待：发票已创建，尚未付款
• 确认：付款已见，正在等待区块链确认
• 已付款：付款已完全确认
• underPaid：收到部分金额
• 已过期：发票因超时而过期

这使您的系统能够立即做出反应，例如，将订单更新为“已付款”、激活订阅或发送确认电子邮件。.

如果您正在构建自己的后端，那么正确保护和验证 Webhook 请求至关重要。这是一个使用 Flask 的更强大的 Python 示例：

从 flask 导入 Flask、request、jsonify app = Flask(__name__) WEBHOOK_SECRET = "YOUR_SECRET_TOKEN" @app.route('/webhook', methods=['POST']) def handle_webhook(): received_secret = request.headers.get('X-Webhook-Secret') if received_secret != WEBHOOK_SECRET: return jsonify({"error": "Unauthorized"}), 403 try: data = request.get_json() track_id = data.get("trackId") status = data.get("status") if status == "paid": print(f" 已确认 {track_id} 的付款") elif status == "underPaid": print(f" 已确认 {track_id} 的部分付款") return jsonify({"status": "ok"}), 200 except Exception as e: print(f" Webhook 错误： {str(e)}") return jsonify({"error": "错误请求"}), 400

为了使其更加安全：

• 仅接受来自已知 IP 地址的 Webhook
• 始终使用 HTTPS 作为回调 URL
• 记录所有传入的 Webhook 事件以供审核或故障排除

即使您自己不编写代码，了解此过程也能确保您能够验证付款是否正在自动且安全地处理和确认。

在您的系统中处理付款状态

一旦您的系统通过 Webhook 收到付款更新，下一步就是在平台内采取适当的操作。这通常意味着将订单标记为已付款、交付数字产品、激活订阅，或者只是通知客户付款成功。

您将在 Webhook 负载中收到关键信息，例如 trackId（每张发票独有）、状态（例如“已付款”或“未付清”）以及金额。借助这些数据，您的系统可以识别付款属于哪个订单以及下一步应该执行的操作。

实际上，这可能看起来像更新数据库中的订单状态：

# 收到 Webhook 后的示例逻辑 if status == "paid": mark_order_as_paid(track_id) send_confirmation_email(user_id) elif status == "underPaid": notify_customer_about_remaining_balance(track_id)

如果您在创建发票时添加了自己的订单 ID，则可以在此处使用它来将付款与您的内部订单系统进行匹配。这有助于确保准确性，尤其是在同时处理多张发票的情况下。

即使您使用 WooCommerce 或 CMS 插件之类的平台，此过程也会在后台自动进行。但是，如果您正在构建自定义流程，则务必确保支付数据实时更新您的系统，以便客户能够立即收到确认，并及时获得服务。

顺畅的付款后流程可以与用户建立信任，并确保交易成功后一切高效运行。

保护您的集成

使用任何支付系统，尤其是涉及加密货币的支付系统时，安全性至关重要。OxaPay 的 API 采用默认安全设计，但将其集成到您的系统中时，您需要自行决定是否采用最佳实践。.

首先，请像对待密码一样对待您的 API 密钥。它赋予您支付系统的完全访问权限，因此切勿将其暴露在公共代码、前端脚本或版本控制平台中。请始终将其存储在服务器端、安全的环境变量或受保护的配置文件中。

接下来，确保您的callbackUrl（Webhook端点）受到保护。

OxaPay 允许您：

• 限制接受的 IP 地址，这样只有 OxaPay 服务器才能访问您的 Webhook
• 使用秘密令牌，无论是在请求标头中还是作为 URL 的一部分，以验证每个传入请求的来源
• 确保始终使用 HTTPS，以便所有数据传输都经过加密，不会被拦截

如果您想验证传入的 Webhook 请求，可以将服务器中的密钥值与 OxaPay 发送的密钥值进行比较。这有助于确保消息未被伪造或篡改。

以下是如何使用令牌验证 Webhook 请求的简化示例：

WEBHOOK_SECRET = "YOUR_SECRET_TOKEN" @app.route('/webhook', methods=['POST']) def handle_webhook(): if request.headers.get('X-Webhook-Secret') != WEBHOOK_SECRET: return jsonify({"error": "Unauthorized"}), 403 # 在此处理支付数据 return jsonify({"status": "ok"}), 200

通过遵循这些简单的步骤，保持您的 API 密钥私密，保护您的 Webhook，并使用 HTTPS，您可以帮助保护您的业务、您的用户以及您的加密支付的完整性。.

安全不必太复杂，只需保持一致即可。

在沙盒模式下测试一切

在上线加密货币支付之前，务必在无风险的环境中测试整个集成流程。OxaPay 提供完整的 沙盒模式 模拟真实的支付行为，无需转移任何实际资金。.

您可以测试一切：发票创建、付款状态更新、webhook 处理，甚至付款不足或交易过期等边缘情况。

如何访问沙盒模式：

1. 登录您的 OxaPay 帐户。
2. 前往 商户应用程序接口 节。
3. 选择 沙盒 选项卡并单击 生成沙盒 API 密钥.
4. 将此密钥与 Sandbox API 端点一起使用：
   https://sandbox.oxapay.com/merchant/invoice

沙盒环境完全反映了生产 API，但不涉及真实的硬币，因此非常适合安全测试。.

示例：在沙盒中模拟发票

导入请求有效负载 = { “商家”：“YOUR_SANDBOX_API_KEY”， “金额”：10，“货币”：“USDT”， “callbackUrl”：“https://yourdomain.com/webhook”， “orderId”：“TEST-001”， “description”：“沙盒测试” } 响应 = 请求.post（“https://sandbox.oxapay.com/merchant/invoice”，json=payload） 打印（response.json（））

这会在沙盒环境中创建一张测试发票。您将获得一个 payLink，在浏览器中打开它并模拟不同的付款操作。.

尝试的测试场景：

• 部分付款：发送少于发票金额的金额以触发 underPaid webhook 状态
• 发票过期：等待超过生命周期（例如 10 分钟）以模拟过期
• 全额付款：完成模拟付款并验证是否触发了付费 webhook

无论您是编写代码还是使用插件，沙盒测试都能让您在上线前充满信心。它有助于确保所有系统、结账、付款状态和履行情况均按预期运行，不会出现任何意外。.

可选：使用高级端点

一旦您的基本加密支付开始运作，OxaPay 会提供额外的 API 工具来扩展您的设置：

• 掉期API – 接受一种货币，即可自动接收另一种货币。例如，您的客户使用 BTC 付款，您将收到 USDT，无需手动转换。.

• 静态地址 API – 为用户分配固定钱包地址，用于定期存款或基于账户的存款。
• 支付 API – 自动向用户进行出站加密货币转移、合作伙伴或供应商。

这些功能不是接受付款所必需的，但当您需要更多灵活性、自动化或规模时，它们就准备好了。

OxaPay 加密支付 API 的商业优势

OxaPay 的 API 不仅带来简单的集成，还能为您的业务增加真正的价值：

• 接受来自任何地方客户的加密货币，不受银行限制。
• 与信用卡或 PayPal 相比，通过最低的区块链费用降低处理成本。
• 自动简化发票、付款跟踪和订单履行。
• 吸引注重隐私、精通技术且喜欢快速加密支付的用户。
• 构建可扩展且有弹性的支付系统，以实现长期增长。

结论

接受加密货币支付 不再需要复杂的基础设施或深厚的区块链知识。借助 OxaPay 的加密支付 API，您现在可以根据业务需求，快速、安全、全自动地启动加密支付。无论您是构建自定义流程的开发人员，还是寻求简单即插即用解决方案的企业主，现在都比以往更加便捷。

考虑到这一点，您已经拥有了前进所需的工具、灵活性和支持。现在，只剩下一步，那就是开始行动。

立即开始

• 创建免费的 OxaPay 帐户 并开始整合加密支付
• 探索 API 文档 提供集成示例和完整的沙盒环境，用于上线前的测试

OxaPay 加密网关 使加密支付变得简单、安全且可扩展，专为满足现实世界的业务需求而设计。.

常见问题