如果您已经在探索 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 步：开始在网站上接受加密货币
Once testing is complete:
- Switch your invoices from sandbox to live mode.
- Monitor payment confirmations in the OxaPay dashboard.
- You’re now ready to accept crypto payments on your website—securely, in real time, and with full visibility through the OxaPay dashboard.
🌟 What Your Customers Experience
- A clean, mobile-friendly checkout screen.
- Real-time QR code and wallet address display.
- Countdown timer for invoice validity.
- Automatic confirmation on payment success.
✨ These visual and functional elements increase trust and reduce drop-offs.
💸 Your First Crypto Payment (Walkthrough)
Here’s what the flow looks like for your very first transaction:
- You create an invoice via plugin or API.
- Customer sees a fully customized payment page.
- They pay using their crypto wallet (scan QR or paste address).
- OxaPay confirms the transaction and updates your system via callback.
- You see the confirmation in your dashboard.
⚡ Most TRON- or BSC-based payments confirm in under 60 seconds.
🧩 Tips for Long-Term Success
- Enable auto-withdrawal to your exchange wallet or cold storage.
- Check transaction history weekly to reconcile invoices.
- Use underpaid tracking for improved recovery rate.
- Educate your support team on payment statuses and invoice expiry.
- Adjust branding and languages based on user location.
📊 Integration Method Comparison
| 方法 | 设置时间 | Complexity | Best For |
| Plugin | ~15 min | Low | WooCommerce, WHMCS, Blesta |
| REST API | 1–3 hours | 中型 | SaaS, custom web apps, backend |
总结：化繁为简。为规模化做好准备。
With OxaPay, you can accept crypto payments on your website without writing complex blockchain code or depending on third-party custodians. The process is fast, secure, and built to scale—from simple plugins to full API control.
🎯 Ready to go live?
Ready to go live? Get started with the OxaPay 加密支付网关 or dive into our API 文档 to build a tailored solution for your business.
