连接 Binance Pay 收款
在 Binance 创建只读 API 密钥，在 ChatHub 中填写 Pay ID、收款币种和汇率，测试连接，并自动为客户钱包充值。
Binance Pay 如何与 ChatHub 配合工作？#
当客户进入“通过 Binance Pay 充值”工作流步骤时，ChatHub 会按配置汇率把充值余额换算成收款币种，并为本次充值预留一个唯一的小数金额。客户把完整金额转到店铺 Pay ID；ChatHub 使用只读 API 密钥查询 Binance Pay 交易历史，按金额匹配后把约定余额充入客户钱包。
- 1
在收款用的 Binance 账户中创建 System generated（HMAC）API Key/API Secret。
- 2
在 Binance Pay 中找到店铺的 Pay ID。
- 3
在 ChatHub 中填写密钥、Pay ID、收款币种和换算汇率，然后测试连接。
- 4
在工作流中使用“通过 Binance Pay 充值”步骤，并用完整金额完成一次测试转账。
1. 准备账户和换算汇率#
- 1
ChatHub 账户具有打开并保存“管理 → 设置 → 支付”的权限。
- 2
Binance 账户满足当前创建 API 密钥的身份验证要求，并能接收 Binance Pay 转账。
- 3
先确定店铺余额单位。如果 ChatHub 钱包按 VND 计价并接收 USDT，可设置如 1 USDT = 25000 余额单位的运营汇率。
- 4
如需按 IP 限制密钥，准备 ChatHub 服务器的公网出口 IP；服务器时钟也要保持同步。
2. 打开 Binance API Management#
- 1
登录用于收款的 Binance 账户，打开 Account → API Management。
- 2
阅读页面上的安全提示：像密码一样保护密钥，条件允许时限制可信 IP，并按 Binance 要求完成 KYC。
- 3
点击 Create API。不要选择 Create Tax Report API，因为该密钥不用于 ChatHub 查询 Binance Pay 历史。
3. 创建只读 HMAC 密钥#
- 1
在 Choose API Key type 中选择 System generated。ChatHub 需要 HMAC API Key 和 API Secret，不支持此表单中的 Self-generated Ed25519/RSA 密钥。
- 2
点击 Next，填写容易识别的标签，例如 ChatHub，然后继续。
- 3
自行完成 Binance 的安全验证并确认创建。本文没有在示例账户上执行最终创建。
- 4
创建后保留 Enable Reading，不要开启现货/杠杆交易、合约、提现或资产划转权限。
- 5
如果服务器有固定出口 IP，可只允许 ChatHub 服务器 IP。安全保存 API Key 和 API Secret，供第 5 步填写。
4. 找到店铺的 Binance Pay ID#
- 1
使用收款账户打开 Binance App，进入 Pay，在 Binance Pay 资料中找到 Pay ID。
- 2
复制数字 Pay ID。ChatHub 也可以发送邮箱或手机号，但 Pay ID 通常更容易核对，也更不容易变化。
- 3
如果只想核对收款人，可以向该标识发起转账并在确认前停止；不要为了截图而实际转账。
5. 在 ChatHub 中填写 Binance Pay 配置#
- 1
在 ChatHub 打开“管理 → 设置 → 支付”，在“加密货币”中展开 Binance Pay。
- 2
填写店铺 Binance Pay ID、刚创建的 API Key 和 API Secret。
- 3
收款币种：填写客户必须转入的资产代码，例如 USDT；其他币种的交易会被 ChatHub 忽略。
- 4
换算汇率：填写 1 个收款币种单位可兑换多少钱包余额。例如 25000 表示 1 USDT 兑换 25000 余额单位。请使用店铺自己的汇率规则，不要把截图数字当作实时市场汇率。
- 5
保存前点击“测试连接”。密钥框中有新值时，ChatHub 测试新密钥；留空时测试服务器已保存的密钥。
- 6
提示密钥可用并能读取历史后点击“保存”，等待“支付设置已保存”，并确认卡片显示“已配置”。
6. 在充值工作流中使用 Binance Pay#
- 1
打开“自动化 → 工作流”，添加或检查“通过 Binance Pay 充值”步骤。
- 2
按店铺钱包单位填写充值金额。ChatHub 会按汇率换算，并生成最多四位小数的唯一收款金额。
- 3
在发给客户的消息中保留 Pay ID、应转金额和币种变量，让每个会话收到准确说明。
- 4
要求客户连同小数部分完整转账。Binance Pay 没有银行转账备注，因此唯一金额就是 ChatHub 匹配付款的依据。
- 5
向真实客户启用前，检查成功、失败和超时分支。
7. 验证收款和余额入账#
- 1
先点击“测试连接”。成功表示服务器能够读取 Binance Pay 历史，不会发生资金转移。
- 2
让一个测试联系人运行到 Binance Pay 步骤，记录充值余额和机器人要求的完整小数金额。
- 3
使用另一个 Binance 账户核对 Pay ID 和收款人姓名，再转入正确币种和完整金额。这是真实资金操作，请按内部流程使用小额测试。
- 4
等待系统查询交易，然后确认工作流继续、客户钱包增加约定余额，余额记录的来源为 Binance。
- 5
如需立即查询，客户可把 Binance 交易 ID 发给机器人；只有与真实历史记录匹配时才会被接受。
8. 常见问题排查#
- 1
Binance 拒绝密钥：重新核对 API Key/API Secret，确认密钥仍有效，并确保 secret 属于该 key；secret 丢失时创建新密钥对。
- 2
缺少读取权限：在 Binance 打开该密钥的 Edit restrictions，启用 Enable Reading，不要开启不需要的资金权限。
- 3
IP 被阻止：把 ChatHub 服务器真实出口 IP 加入 allowlist；也可暂时取消限制定位原因，之后再恢复安全配置。
- 4
服务器时间错误：用 NTP 同步服务器时钟后重试。
- 5
网络或限流错误：确认服务器能访问 api.binance.com，检查 DNS/防火墙，并等待一段时间再试。
- 6
密钥可用但未入账：检查配置币种、完整小数金额、充值请求是否仍在等待，以及转账是否在创建请求后的 24 小时内完成。
- 7
客户转错金额或资产：不要修改交易数据强制匹配；请人工对账，并按店铺退款或人工加款流程处理。
9. 安全与运营#
- 1
限制可管理 ChatHub 支付设置和 Binance API Management 的人员。
- 2
基础设施有固定 IP 时使用 allowlist，并定期确认密钥只有 Enable Reading。
- 3
怀疑泄露时，立即在 Binance 禁用或删除密钥，创建并测试替代密钥，再更新 ChatHub。
- 4
定期检查店铺汇率；测试期间如需改动，先保存机器人已经发给客户的金额。
- 5
对照 Binance Pay 历史与 ChatHub 钱包记录，系统已入账的交易不要再次手工加款。