快速开始
初次使用 Eppay？以下三步涵盖了每位商家在接受第一笔加密支付前所需的全部内容。
1. 注册账户并验证邮箱
使用邮箱或社交登录（Google、Facebook）在 eppay.io 注册。请验证收件箱中的邮件地址，以便我们向您发送支付通知和安全提醒。
2. 添加收款钱包地址
打开"设置"，针对您计划接受支付的每条区块链，粘贴一个您自己控制的钱包地址。Eppay 从不托管资金——每笔款项都直接结算到您设定的地址。
3. 生成 API 密钥或创建支付链接
一次性账单可创建一个"商品"并分享托管的支付链接。结账集成则在 API 选项卡中生成 API 密钥，并调用 POST /api/v2/create-payment 以编程方式创建链接。
支付与确认
Eppay 在以下网络上处理 USDT 和 USDC 稳定币支付。每条链的确认速度和手续费特征不同。
支持的网络
以太坊、币安智能链（BSC）、Polygon、Arbitrum、Avalanche、Fantom、Cronos、Celo 与 Cosmos。我们持续根据商家需求增加新链——请告诉我们您需要哪条网络。
支持的代币
在每条受支持的链上提供 USDT（Tether）和 USDC（USD Coin）。两者均为锚定美元的稳定币，因此客户发送的金额与您在结账时显示的价格一致。
确认需要多长时间？
确认时间因链而异。在 BSC、Polygon 和 Arbitrum 上，支付通常在不到一分钟内完成确认。在以太坊主网，正常网络条件下大约 1–3 分钟，手续费暴涨时会更长。当链上交易达到所需确认深度后，Eppay 会立即将该笔支付标记为"已完成"。
网络手续费由谁支付？
客户在其选择的链上支付 Gas 费。除账户仪表盘中披露的平台费用外，Eppay 不从支付本身额外收取费用。
客户少付了怎么办？
若客户发送金额少于请求金额，该笔支付将记录为部分支付，链接会保持开启直到收到剩余余额或链接到期。部分支付的退款由您与客户直接处理；Eppay 不持有资金。
API 与集成
Eppay 提供 REST API、Shopify 应用，以及用于将结账嵌入任何 Web 技术栈的 JavaScript SDK。
在哪里获取 API 密钥？
登录后，从仪表盘打开 API 选项卡并点击"创建 API 密钥"。每个密钥仅限您的账户使用，您可以随时撤销和轮换密钥。请将 API 密钥视同密码，仅在服务器端存储。
应使用 API v1 还是 v2？
所有新集成请使用 v2。v2 端点（POST /api/v2/create-payment、GET /api/v2/payments/{id}/status）是受支持的标准。v1 端点仍为旧调用方提供响应，但不应用于新开发。
是否支持 Webhook？
支持。在账户中配置 Webhook URL，当支付状态变更时，Eppay 会以 POST 方式发送已签名的 JSON 负载。在信任事件之前，请在您这一端校验签名头。
Shopify 集成如何工作？
从 Shopify 应用商店安装 Eppay 应用，将其连接到您的 Eppay 账户，加密就会成为客户结账的支付选项之一。款项会结算到您在 Eppay 中配置的钱包；链上交易确认后，订单会在 Shopify 中自动标记为已支付。
账户与安全
一些常见的账户问题：
我忘记了密码
在登录页使用"忘记密码"链接。我们会发送一封 60 分钟内有效的重置邮件。如果未收到邮件，请检查垃圾邮件，并确认您注册时使用的地址。
如何启用双因素认证？
打开个人资料设置并按照 2FA 设置向导操作。建议在添加钱包地址或生成 API 密钥之前先启用 2FA。
可以更改钱包地址吗？
可以。在"设置"中随时更新地址。后续支付将路由到新地址。已在进行中的支付仍按链接创建时所设的地址结算。
故障排除
我们最常遇到的五个问题及解决方法：
我的支付一直显示"待处理"
"待处理"表示交易已广播，但尚未达到该链所需的确认深度。请在区块浏览器中查询交易哈希（以太坊用 etherscan.io，BSC 用 bscscan.com，Polygon 用 polygonscan.com 等），确认交易已被打包。如果链上显示已确认，但 Eppay 上 10 分钟后仍为待处理，请附上交易哈希联系我们。
客户在错误的链上支付
若您以同一钱包地址在另一条您控制的链上收到款项（多数 EVM 链共用相同地址格式），可在该链上找回资金。如果客户发送至您没有私钥的链，那笔资金无法通过 Eppay 找回，敬请理解。
API 密钥返回 401 Unauthorized
请检查您是否在 Authorization 头部以 Bearer 令牌方式传递密钥、密钥是否未在仪表盘中被撤销，以及是否调用了正确的环境。最后再尝试重新生成密钥。
显示金额与发送金额不一致
Eppay 以稳定币（USDT 或 USDC）报价金额，因此 1 USDT 入即 1 USDT 出——不存在汇率换算。如果客户发送了不同的代币（例如发送 ETH 而非 USDT），支付将无法匹配。小数精度因链而异；默认显示 6 位小数。
Webhook 从未触发
请确认 URL 可公网访问（不是 localhost 或仅 VPN 可达的主机）、能在 5 秒内返回 HTTP 2xx，且没有防火墙阻挡我们的 IP。失败的投递我们会以指数退避重试最长 24 小时。
响应时间
我们力争在一个工作日内（周一至周五）回复每一封邮件。阻碍支付的紧急问题将优先处理。我们的工作时间以中欧时间为准，但团队分布在多地，常常也会在工作时间之外回复。
为获得更快的回复，请在首封邮件中提供：账户邮箱、相关的支付 ID 或交易哈希、所用网络，以及截图或错误信息。
商务与合作咨询
如有合作伙伴、规模化集成、定制结算条件或媒体咨询，请将主题写为"Partnership"，并附上对您所做项目的简短说明，发送至 info@eppay.io。我们会在两个工作日内回复每一份正式咨询。