地址池设置

快速开始使用 PayIn 地址池系统 - 从生成地址到导入使用的完整指南。

概述

地址池是 PayIn 实现非托管支付的核心设计。与传统支付平台不同，PayIn 不保管您的资金，所有支付款项直接进入您自己控制的钱包地址。

💎 非托管支付的优势

🔐 完全控制：您拥有私钥（助记词），完全掌控资金
💰 即时到账：支付直接到您的地址，无需平台转账
🛡️ 零风险：PayIn 无法接触您的资金，消除平台跑路风险
🚀 规模灵活：业务越大，准备更多地址即可

什么是地址池？

地址池是您预先生成的区块链收款地址集合。PayIn 会从中动态分配地址用于订单支付和用户充值，但这些地址的私钥始终由您控制。

使用地址池可以实现：

⚡ 即时分配：无需等待地址生成
🔄 地址复用：订单完成后地址自动回收（带冷却保护）
🌐 多链支持：统一管理 EVM、Tron、Solana 等多条链的地址

🔑 助记词与钱包地址的关系

助记词（通常是 12 或 24 个英文单词）是您钱包的"万能钥匙"：

助记词（1组12个单词）
    ↓
可以生成无限个钱包地址
    ↓
地址 #0: 0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0
地址 #1: 0x8db97C7cEcE249c2b98bDC0226Cc4C2A57BF52FC
地址 #2: 0x1234567890123456789012345678901234567890
地址 #3: ...
地址 #100: ...
    ↓
所有地址的资金都在您的控制之下

关键概念：

✅ 一组助记词 → 可以派生出成千上万个地址
✅ 所有地址的资金 → 都由同一个助记词控制
✅ 备份助记词 → 等于备份了所有地址的私钥
⚠️ 助记词丢失 → 所有地址的资金将永远无法找回

安全提醒

助记词是您所有资金的唯一凭证，请务必：

📝 写在纸上，存放在安全的地方（保险箱、银行保险柜）
🚫 不要截图、不要保存在电脑或云盘
🚫 不要告诉任何人，包括 PayIn 团队
✅ 建议在不同地点保存多份备份

快速开始（推荐）

如果您是首次使用 PayIn，我们推荐以下快速方式生成地址：

🌐 方式一：使用在线工具（最快捷）

访问 wallet-tool.payin.com 在线生成地址：

打开浏览器无痕模式（推荐）
- Chrome/Edge: Ctrl+Shift+N (Windows) 或 ⌘+Shift+N (Mac)
- Firefox: Ctrl+Shift+P (Windows) 或 ⌘+Shift+P (Mac)
- Safari: ⌘+Shift+N (Mac)
访问工具网站 打开 https://wallet-tool.payin.com
生成助记词
- 点击"生成新助记词"按钮
- 将 12 个单词的助记词安全备份（写在纸上，存放在安全的地方）
- 勾选"我已安全备份助记词"确认
选择协议
- 选择您需要的区块链协议（EVM / Tron / Solana）
- EVM 协议支持：Ethereum、Polygon、BSC 等多条 EVM 兼容链
生成地址
- 设置起始索引（通常为 0）
- 设置生成数量（建议 50-100 个）
- 点击"生成地址"
导出 CSV
- 点击"下载 CSV"按钮
- 保存文件到本地（例如：addresses-evm.csv）

安全提醒

⚠️ 在线工具仅用于测试环境
⚠️ 助记词在您的浏览器本地生成，不会发送到服务器
⚠️ 使用无痕模式可防止浏览器缓存助记词
⚠️ 生产环境请使用离线方式（见方式二）

💻 方式二：使用本地钱包软件（最安全）

适合生产环境使用，需要您有一定的技术基础：

MetaMask（推荐用于测试）

安装 MetaMask 浏览器插件 从 metamask.io 下载安装
创建新钱包
- 生成并备份 12 个单词的助记词
- 设置密码
导出地址
- 创建多个账户（点击账户头像 → 创建账户）
- 复制每个账户的地址
- 手动创建 CSV 文件

硬件钱包（推荐用于生产）

Ledger / Trezor 硬件钱包提供最高安全级别：

✅ 私钥安全：私钥永不离开硬件设备
✅ 防篡改：硬件级别保护
✅ 适合生产：管理大额资金
✅ 支持多链：EVM、Tron 等主流链

详细操作步骤请参考硬件钱包官方文档。

📱 方式三：使用手机钱包

Trust Wallet、imToken 等手机钱包：

在应用商店下载钱包应用
创建新钱包并备份助记词
创建多个账户
导出地址列表

推荐组合

测试环境：使用 wallet-tool.payin.com 快速生成
小规模生产：使用 MetaMask 或手机钱包
大规模生产：使用 Ledger/Trezor 硬件钱包

导入地址到 PayIn

无论使用哪种方式生成地址，都需要将地址导入到 PayIn Admin 后台：

步骤 1：准备地址列表

PayIn 支持两种方式导入地址：

方式 A：CSV 文件（推荐）

创建一个 CSV 文件，可以包含派生索引信息：

基础格式（仅地址）：

csv

address
0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0
0x8db97C7cEcE249c2b98bDC0226Cc4C2A57BF52FC
0x1234567890123456789012345678901234567890

完整格式（包含派生索引）：

csv

address,derivation_index
0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0,0
0x8db97C7cEcE249c2b98bDC0226Cc4C2A57BF52FC,1
0x1234567890123456789012345678901234567890,2
TYASr5UV6HEcXatwdFQfmLVUqQQQMUxHLS,0
TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t,1

CSV 格式说明

必填字段：

address：钱包地址（必须）

可选字段：

derivation_index：HD 钱包派生索引（可选，推荐）
- 追踪地址是从助记词的第几个位置派生的
- 帮助防止生成重复地址
- 如果使用 MetaMask、手机钱包等工具生成的独立地址，可以省略

格式支持：

基础格式：仅地址（每行一个）
完整格式：address,derivation_index（CSV 带表头）

其他说明：

使用 CSV 格式时，第一行必须是表头（address 或 address,derivation_index）
从第二行开始，每行一个地址
协议在 Admin UI 中选择，不在 CSV 文件中指定
PayIn 会自动验证地址格式

方式 B：复制粘贴

也可以直接在 Admin UI 中粘贴地址列表，每行一个地址：

0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0
0x8db97C7cEcE249c2b98bDC0226Cc4C2A57BF52FC
0x1234567890123456789012345678901234567890

不需要表头，直接粘贴地址即可。使用此方式导入的地址不会包含派生索引信息。

步骤 2：登录 PayIn Admin

访问您的 PayIn Admin 后台
使用您的账号登录
选择对应的组织（Organization）

步骤 3：导入地址

进入地址池页面 侧边栏导航 → Address Pool
选择协议类型 选择要导入的地址协议：EVM、Tron 或 Solana
选择导入方式
方式 A：上传 CSV 文件
- 点击"Upload CSV"按钮
- 选择或拖拽您的 CSV 文件
方式 B：粘贴地址
- 点击"Paste Addresses"按钮
- 在文本框中粘贴地址列表（每行一个地址）
检查预览
- 查看将要导入的地址列表
- 确认协议类型和数量
- 系统会自动验证地址格式
确认导入
- 点击"Confirm Import"
- 等待导入完成（大量地址可能需要几秒钟）
验证导入
- 检查地址池统计数据
- 确认"Available"地址数量增加

导入成功

导入成功后，您会在 Address Pool 页面看到新导入的地址，状态为 "available"（可用），可以立即用于订单支付和用户充值。

地址数量规划

选择合适的地址数量对于确保支付系统稳定运行非常重要。

订单支付业务

对于 订单支付（Order Payment）场景，地址会自动复用：

地址数量	每天可支持订单数	适用场景
5 个	约 160 单/天	小型测试、个人项目
20 个	约 640 单/天	小型商户、初创公司
100 个	约 3,200 单/天	中型电商、游戏平台
500 个	约 16,000 单/天	大型平台、高频交易

计算说明

地址复用机制：

订单生命周期：支付窗口（10分钟）+ 宽限期（5分钟）= 15分钟
冷却期：订单完成后需要冷却 30 分钟才能重新分配
完整周期：15 + 30 = 45 分钟
每天可用次数：1440 分钟 ÷ 45 分钟 = 32 次/天/地址

例如：5 个地址 × 32 次/天 = 160 单/天

注意：实际容量可能因订单完成速度、过期订单等因素有所不同。建议保留 20% 余量。

用户充值业务

对于 用户充值（Deposit）场景，每个用户需要一个永久地址：

用户数量	所需地址数量	说明
100 用户	100 个地址	每个用户绑定一个充值地址
1,000 用户	1,000 个地址	地址与用户一一对应
10,000 用户	10,000 个地址	按需扩展地址池

什么是用户充值？

用户充值（Deposit）是为外部系统的用户永久分配一个专属充值地址的功能。用户可以多次向该地址转账充值，每笔充值都会自动记录到用户账户。

适用场景：

游戏平台的游戏币充值
交易所的入金充值
钱包应用的余额充值

详细介绍请参阅：用户充值服务指南

混合业务场景

如果同时运行订单支付和用户充值业务：

示例：一个中型游戏平台

订单支付：每天 500 个道具购买订单 → 需要约 20 个地址
用户充值：5,000 个活跃玩家 → 需要 5,000 个地址
总计：约 5,020 个地址

重要提醒

订单地址和充值地址会自动分配，无需手动区分
充值地址一旦绑定给用户，将永久占用，不会释放
建议预留 10-20% 的地址余量，以应对业务增长

CSV 格式示例

基础格式（仅地址）

适合从 MetaMask、手机钱包等工具手动创建的地址：

csv

address
0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0
0x8db97C7cEcE249c2b98bDC0226Cc4C2A57BF52FC
0x1234567890123456789012345678901234567890

完整格式（包含派生索引）

推荐使用，适合从 HD 钱包或 wallet-tool.payin.com 生成的地址：

EVM 地址示例：

csv

address,derivation_index
0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0,0
0x8db97C7cEcE249c2b98bDC0226Cc4C2A57BF52FC,1
0xdAC17F958D2ee523a2206206994597C13D831ec7,2
0x9876543210987654321098765432109876543210,3
0xabcdefabcdefabcdefabcdefabcdefabcdefabcd,4

Tron 地址示例：

csv

address,derivation_index
TYASr5UV6HEcXatwdFQfmLVUqQQQMUxHLS,0
TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t,1
TN3W4H6rK2ce4vX9YnFQHwKENnHjoxb3m9,2

Solana 地址示例：

csv

address,derivation_index
7xVq3CzVvVx4Qn8h9kLQn8qZKq8KqVq3h7xVq3CzVvVx4,0
DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK,1
9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM,2

为什么要包含派生索引？

派生索引（derivation_index）记录了地址是从助记词的第几个位置派生出来的：

优势：

✅ 可追溯性：知道每个地址对应助记词的哪个索引
✅ 便于管理：可以按索引顺序重新生成地址
✅ 防止重复：下次生成新地址时，从最大索引+1开始
✅ 故障恢复：如果需要恢复钱包，可以准确重现所有地址

示例：

第一批生成 100 个地址（索引 0-99）
第二批从索引 100 开始生成，避免重复

混合协议示例

一次导入多个协议的地址（每个协议的索引独立计数）：

csv

address,derivation_index
0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb0,0
0x8db97C7cEcE249c2b98bDC0226Cc4C2A57BF52FC,1
0xdAC17F958D2ee523a2206206994597C13D831ec7,2
TYASr5UV6HEcXatwdFQfmLVUqQQQMUxHLS,0
TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t,1
7xVq3CzVvVx4Qn8h9kLQn8qZKq8KqVq3h7xVq3CzVvVx4,0
DYw8jCTfwHNRJhhmFcbXvVDTqWMEVFBX6ZKUmG5CNSKK,1

注意

不同协议的派生路径不同，所以不同协议的索引可以重复：

EVM 地址的索引 0 和 Tron 地址的索引 0 是两个不同的地址
每个协议维护自己的索引序列

常见问题

Q: 需要生成多少个地址？

答案取决于您的业务类型：

仅订单支付：

参考上方"地址数量规划"中的订单支付表格
根据预计每天订单量选择合适数量
建议预留 20% 余量

仅用户充值：

地址数量 = 用户数量
按实际用户规模准备地址
可以分批导入，随着用户增长逐步补充

混合业务：

订单地址数量（可复用）+ 用户充值地址数量（永久占用）
参考上方"混合业务场景"示例

动态补充

PayIn 支持随时导入新地址。建议保持地址池中至少 20% 的可用地址，当可用地址不足时及时补充。

Q: 地址可以重复使用吗？

是的，PayIn 采用智能地址复用机制：

✅ 订单地址：订单完成后，地址经过 30 分钟冷却期后自动返回地址池
✅ 冷却保护：防止地址立即重用，保护隐私和安全
✅ 充值地址：永久绑定给用户，不会回收

Q: 如何确保助记词安全？

安全实践：

✅ 离线生成：生产环境使用离线电脑或硬件钱包
✅ 物理备份：将助记词写在纸上，存放在保险箱
✅ 多重备份：在不同地点保存多份备份
❌ 禁止：不要截图、不要保存在云盘、不要发送给任何人

重要提醒

助记词等同于所有地址的私钥。任何人获得助记词，就能控制所有地址中的资金。请妥善保管！

Q: wallet-tool.payin.com 是否安全？

安全特性：

✅ 所有操作在浏览器本地完成，助记词不会发送到服务器
✅ 开源代码，可以审计
✅ 建议使用无痕模式，防止浏览器缓存

限制：

⚠️ 仅推荐用于测试环境
⚠️ 生产环境请使用离线方式或硬件钱包

Q: 导入地址后可以删除吗？

地址状态与删除：

✅ available（可用）：可以删除
⚠️ allocated（已分配）：等待订单完成后删除
⚠️ bound（已绑定）：需先解绑才能删除
❌ 不建议删除：除非地址私钥丢失或安全问题

Q: 多个组织可以共享地址吗？

不可以。PayIn 采用多租户架构，每个组织的地址池完全隔离：

❌ 地址不能在组织间共享
✅ 每个组织独立管理自己的地址池
✅ 确保业务数据和资金完全隔离

下一步

地址池设置完成后，您可以：

📝 创建订单支付 - 开始接收加密货币支付
💰 配置用户充值 - 为用户提供充值服务
🔔 设置 Webhook 通知 - 接收支付通知
🔗 创建支付链接 - 无需编码的快速支付方式

高级话题

想要深入了解地址管理系统？请参阅：

📖 地址管理详解 - 完整的地址池概念、状态管理和工作流
🔧 API 集成 - 通过 API 管理地址池
🔐 安全最佳实践 - 密钥管理和安全建议

地址池设置 ​

概述 ​

💎 非托管支付的优势 ​

🔑 助记词与钱包地址的关系 ​

快速开始（推荐） ​

🌐 方式一：使用在线工具（最快捷） ​

💻 方式二：使用本地钱包软件（最安全） ​

MetaMask（推荐用于测试） ​

硬件钱包（推荐用于生产） ​

📱 方式三：使用手机钱包 ​

导入地址到 PayIn ​

步骤 1：准备地址列表 ​

方式 A：CSV 文件（推荐） ​

方式 B：复制粘贴 ​

步骤 2：登录 PayIn Admin ​

步骤 3：导入地址 ​

地址数量规划 ​

订单支付业务 ​

用户充值业务 ​

混合业务场景 ​

CSV 格式示例 ​

基础格式（仅地址） ​

完整格式（包含派生索引） ​

混合协议示例 ​

常见问题 ​

Q: 需要生成多少个地址？ ​

Q: 地址可以重复使用吗？ ​

Q: 如何确保助记词安全？ ​

Q: wallet-tool.payin.com 是否安全？ ​

Q: 导入地址后可以删除吗？ ​

Q: 多个组织可以共享地址吗？ ​

下一步 ​

高级话题 ​