如果您已经在探索 OxaPay如果您正在寻找一种可靠的方式在您的网站上接受加密货币支付，那么您很可能正在寻找一种没有复杂性、延迟或额外风险的方式。本指南是根据实际实施经验编写的，向您展示了如何开始使用，无论是设置支付链接、安装插件还是集成完整的 API。
开始之前：集成前核对表
在进入集成步骤之前，请确保您已准备好以下内容：
- 功能性网站（WordPress、SaaS 或自定义后台）。
- 管理员权限，用于安装插件或编辑后台代码。
- 业务目标：您是否接受加密货币用于产品、订阅或捐赠？
- 创建并验证您的 OxaPay 账户 (无需 KYC/KYB).
- 可选：如果您计划使用 API，则需要开发人员访问权限。
确保您的平台和团队已做好技术准备，无论是否有开发人员参与，都能直接在网站上支持加密货币交易。
🧭 提示：如果您不确定使用哪种方法（插件或 API），请查看末尾的对照表。
第 1 步：创建 OxaPay 账户并访问您的 API
整合开始前，您需要一个经过验证的 OxaPay 账户。具体步骤如下
- 在 oxapay 注册- 无需 KYC/KYB。
- 进入仪表板 > API 设置。
- 复制您的 商户 API 密钥 并记下您的回电秘密。
这些证书是您的网站与 OxaPay 之间安全连接的基础，也是您能够完全控制网站接受加密货币支付的第一步。
🔒 开发人员小贴士：
为了提高安全性，请定期轮换 API 密钥，并将其存储在环境变量中，而不是代码库中。
步骤 2：选择正确的整合方法
OxaPay 支持多种方式将加密支付集成到您的网站。请根据您的网站类型和技术能力进行选择：
1.插件集成（无需代码）
是 WooCommerce、WHMCS 和 Blesta 等电子商务和计费平台的理想选择。OxaPay 还支持以下其他平台探索所有加密货币支付插件和集成 为您的业务服务。
怎么做
- 安装插件 OxaPay 文档页面.
- 在设置中粘贴您的 API 密钥。
- 设置您喜欢的硬币和支付超时。
- 完成。直播开始
⏱ 安装时间：~15 分钟
2.应用程序接口集成（面向开发人员）
如果运行的是自定义平台，则使用 使用 OxaPay 的 REST API 创建发票 并通过完全的后台控制来处理交易。
您将使用的核心终端：
- POST /api/create-invoice
- GET /api/check-invoice
- 网络钩子:带 HMAC 校验的 POST 回调
基本流程：
- 您的后台会生成一张包含金额、硬币类型和重定向 URL 的发票。
- OxaPay 返回一个唯一的支付地址。
- 客户通过钱包或 QR 码付款。
- OxaPay 会确认交易，并向您的回调 URL 发送已签名的 Webhook。
集成通常需要大约 80-150 行后台代码。
无论您是使用插件还是构建完全自定义的后台，这两种方法都能帮助您在网站上可靠地接受加密货币支付。要深入了解 API 的工作原理和使用方法，请参阅我们关于 加密支付应用程序接口和使用案例.
📦 开发人员园地 - Python 代码示例
导入请求
导入 hmac、hashlib
API_KEY = "your-api-key"
CALLBACK_SECRET = "your-secret" 返回密码
发票数据 = {
金额49.99,
"currency"："USDT"、
"callback_url"："https://your-site.com/payment-callback"
}
response = requests.post("https://api.oxapay.com/api/create-invoice", json=invoice_data, headers={"Authorization"：API_KEY})
print(response.json())
def verify_signature(data, signature)：
return hmac.new(CALLBACK_SECRET.encode(), data.encode(), hashlib.sha256).hexdigest() == signature
📘 回调简化版
确保您的回调端点可公开访问，并返回 HTTP 200 OK.
您可以记录接收到的 职位 请求，以验证结构并测试签名验证逻辑。
步骤 3：自定义付款行为
您可以调整 OxaPay 在您的网站上处理付款的方式：
- 自动转换: 立即将收到的加密货币转换为 USDT .
- 发票超时:定义发票的有效期。
- 追回少付款项:如果用户发送的金额少于所需金额，可让用户完成付款。
- 语言和品牌:自定义付款页面标题、徽标和语言。
在创建发票时，可通过仪表板或 API 参数访问这些设置。
对这些选项进行微调可确保您的客户在网站上接受加密货币支付时获得一致的体验，并与您的品牌和运营需求保持一致。
⚙️ 给开发人员的高级提示：
要动态执行品牌，可在通过 API 创建发票时传递自定义_logo_url、语言和 redirect_after 字段。
🔗 有兴趣打造品牌加密货币结账体验？了解更多 如何创建自定义支付网关.
步骤 4：上线前测试集成效果
始终使用 OxaPay 的沙盒 环境
- 用虚拟金额创建测试发票。
- 使用测试钱包模拟付款确认。
- 验证回调是否到达服务器并触发正确的逻辑（例如，将订单标记为已付款）。
🔐 开发人员小贴士：
使用每次回调中发送的 HMAC 签名，使用回调密文验证真实性。记录失败的验证尝试，以监控潜在的滥用。
🛠 常见问题的故障排除
- 发票已过期？ 在设置中延长超时时间或允许快速重新生成。
- 交易报酬过低？ 启用 "少付恢复"，以便客户完成其他操作。
- 没有收到回电？ 确保服务器端点是公共的，并能正确接受 POST 请求。
🧪 测试提示：
您可以在测试网络上使用 TronLink 或 MetaMask 等测试钱包模拟支付。OxaPay 为安全实验提供了专用的沙盒模式。适当的测试可降低失败率，确保您的系统真正准备好在真实世界条件下接受网站上的加密货币支付。
第 5 步：开始在网站上接受加密货币
测试完成后：
- 将您的发票从沙盒模式切换到实时模式。
- 在 OxaPay 仪表板中监控付款确认。
- 您现在可以在您的网站上接受加密支付——安全、实时，并且可以通过 OxaPay 仪表板完全查看。
🌟 您的客户体验如何
- 简洁、适合移动设备的结账屏幕。
- 实时二维码和钱包地址显示。
- 发票有效期的倒计时器。
- 付款成功后自动确认。
✨ 这些视觉和功能元素增加了信任并减少了流失。
💸 您的首次加密货币付款（演练）
以下是您的第一笔交易的流程：
- 您可以通过插件或 API 创建发票。
- 客户看到完全定制的付款页面。
- 他们使用加密钱包付款（扫描二维码或粘贴地址）。
- OxaPay 确认交易并通过回调更新您的系统。
- 您会在仪表板中看到确认信息。
⚡ 大多数基于 TRON 或 BSC 的付款在 60 秒内确认。
🧩 长期成功的秘诀
- 启用自动提款到您的交易钱包或冷库。
- 每周检查交易历史记录以核对发票。
- 使用低薪追踪来提高恢复率。
- 向您的支持团队介绍付款状态和发票到期情况。
- 根据用户位置调整品牌和语言。
📊 集成方法比较
| 方法 | 设置时间 | 复杂 | 最适合 |
| 插件 | 约 15 分钟 | 低的 | WooCommerce、WHMCS、Blesta |
| REST API | 1–3小时 | 中型 | SaaS、自定义 Web 应用程序、后端 |
总结：化繁为简。为规模化做好准备。
使用 OxaPay，您可以在网站上接受加密货币支付，无需编写复杂的区块链代码或依赖第三方托管机构。整个流程快速、安全，并且可扩展——从简单的插件到完整的 API 控制。
🎯 准备好上线了吗？
准备好上线了吗？立即开始 OxaPay 加密支付网关 或者深入了解我们的 API 文档 为您的业务构建量身定制的解决方案。
