一个账号多个店铺：PayRam 多项目（Multi-brand）怎么用

1. 什么时候该拆成多个项目

• 多个品牌或店铺：各自有网站、logo 和客户，希望订单和报表分开看。
• 不同地区的站点：为不同国家或币种做本地化的站点，分别统计。
• 新业务试水：想先小范围测试一个新品类，又不想弄乱现有数据。
• 不同部门：比如零售、批发、数字业务，需要分开核算。
• 隔离测试与正式环境：给测试单独建一个项目，使用单独的 API 密钥和回调地址。

如果只有一个网站、一个业务，一个项目就够了。

2. 怎么新建项目

按官方文档，在后台 设置 → 账号（Settings → Accounts）里点击 新建项目（New Project），然后填写：

1. 项目名称、网站地址、跳转地址（Redirection URLs）。
2. 品牌：logo、颜色、社交媒体链接等。
3. 项目专属的 API 和 Webhook 端点。
4. 项目专属的付款方式和钱包。

如果你的账号里没有新建项目的入口，请联系我们开通。

3. 每个项目独立的 API 密钥和 Webhook

每个项目都有自己的一套 API 密钥和 Webhook 端点。这样做有几个好处：

• 测试与正式隔离：测试项目的密钥泄露，不影响正式项目。
• 可追溯：每个项目的调用和回调都是分开的，出了问题容易定位。
• 方便对接多个网站：每个网站用自己项目的密钥。
• 更安全：可以按项目更换或停用密钥，不影响其他项目。

要注意：Webhook 签名用的是该项目的 API 密钥。多个项目时，校验签名要用对应项目的密钥，否则会一直对不上。详见 Webhook 完全指南。

代码里也一样：每个项目对应一个客户端实例和一个密钥，见 SDK 入门 和 API 对接教程。

4. 钱包与热钱包怎么配置

• 充值钱包：创建项目后，为它接收的网络设置充值钱包（连接主账户、填冷钱包地址、部署合约）。步骤见 商家上手指南。
• 热钱包：每个项目要为它接收的网络配置热钱包，没有共用的兜底。同一个热钱包可以分配给多个项目：在热钱包那一行点击项目数量旁边的编辑图标，选择哪些项目使用它。
• 热钱包余额：多个项目共用一个热钱包时，它们会共同消耗里面的余额，要把余额留得宽裕一些。

热钱包的作用和该放多少钱，见 钱包分工。

5. 日常管理：切换、筛选、权限

• 切换项目：用左侧菜单里的下拉框切换当前项目。
• 编辑信息：项目的 logo、网址等，可以随时在项目设置里修改。
• 分配角色：用用户管理功能，按项目限制团队成员能看什么、能做什么。
• 查看数据：统计、交易和支付链接都可以按项目筛选。

6. 常见问题

项目数量有限制吗？

官方文档没有给出固定上限。在 PayRamHost 上，如果你需要建很多项目，请先联系我们确认。

不同项目的资金会混在一起吗？

不会混淆：每个项目的支付、充值地址和数据是分开的。资金最终归集到你为该项目设置的冷钱包地址。

一个项目的 API 密钥能用于另一个项目吗？

不能。每个请求只属于该密钥所在的项目。

相关阅读

• API 创建支付：用 PayRam API 给自己的网站接加密货币收款：创建支付拿到付款链接，把客户引到支付页，用 Webhook 和状态接口确认到账，并用订单号对账。附 curl、Node.js、Python 示例。
• Webhook 完全指南：PayRam Webhook 怎么接：在后台添加回调地址，用 X-Payram-Signature 校验签名，理解重试规则与支付状态，做幂等处理，附 Node.js 和 Python 示例。
• 商家上手指南：PayRam 商家后台中文上手指南：从登录后台到收到第一笔付款，涵盖节点、钱包、热钱包、支付链接、API 与 Webhook 配置。