edgeKey/docs/pay/hashpay/start.md

HashPay 加密货币支付接入教程

HashPay 是一个加密货币收款网关，支持 USDT、USDC、ETH 等多种币种，运行在 Cloudflare Workers 上。

第一步：获取密钥

1. 部署并登录你的 HashPay 后台
2. 进入「商户」，在「商户列表」新增一个商户
3. 在「新增商户」弹窗输入商户名称(如: 发卡站)和回调地址 (回调地址为发卡站域名 + Notify URL 如: https://shop.v50.app/api/payments/hashpay/notify)之后点击新增
4. 在弹出的「接入凭据」弹窗 复制 商户 ID 和 RSA 私钥，私钥只显示一次，请立即复制保存

⚠️ 你需要的是 私钥（-----BEGIN PRIVATE KEY-----），不是公钥。

第二步：填写配置

登录 EdgeKey 管理后台，进入「系统配置」→「支付配置」→ HashPay 标签页：

字段	填写内容
网关地址	你的 HashPay 域名，如 https://pay.example.com 结尾不要斜杠/
商户 ID	HashPay 后台获取的商户 ID（UUID 格式）
商户 RSA 私钥	创建商户时获取的私钥，完整粘贴包含头尾

第三步：启用并保存

1. 打开右上角的「启用」开关
2. 点击「保存配置」

⚠️ 启用前请先在「站点设置」中配置网站地址，否则支付回调无法正常工作。

第四步：测试

1. 在前台选择一个商品下单
2. 选择 HashPay 支付
3. 确认能正常跳转到收银台页面

常见问题

下单报错"服务器开小差"

• 检查私钥是否粘贴完整，不要漏掉 -----BEGIN PRIVATE KEY----- 和 -----END PRIVATE KEY-----
• 确认粘贴的是私钥而不是公钥

支付成功但订单未更新

• 检查「站点设置」中的网站地址是否正确
• 确认 HashPay 后台的回调地址配置正确

收银台页面打不开

• 检查网关地址是否正确，末尾不要加 /
• 确认 HashPay 服务正常运行

相关链接

• HashPay 项目主页
• EdgeKey 项目主页