本页内容
Terminal
把项目链接当作手机或平板上的面对面加密货币收银终端：输入金额、出示 QR 码、跟踪确认。
在手机或平板上打开链接，在数字键盘上输入金额，把设备递给客户。付款确认后，页面自动回到数字键盘——准备接待下一笔。
Terminal 开箱即用。不写代码、不嵌 API key、不需要服务端。品牌、币种和启用的网络全部继承自项目设置。
在哪里获取终端 URL
终端跟着项目的集成方式走。集成方式在创建项目时选定，之后不可更改，也没有单独的终端开关——只有集成方式为「收银终端」的项目才有终端。现有项目选的是别的方式，就为门店新建一个。
- 在控制台选中该项目。
- 打开收银终端页面。
- 在终端访问卡片里复制 终端 URL。
URL 形如：
https://paymos.io/terminal?key=pk_live_xxx&pid=prj_yyy
把链接发给收银员，或存到收银设备的浏览器书签。
旧地址 /pos 仍然有效：它带着完整查询字符串永久跳转到 /terminal，收银设备上存过的旧书签照常打开。新发出去的链接一律用 /terminal。
URL 里有什么
| 参数 | 用途 |
|---|---|
key |
项目的公开 key（前缀 pk_live_ 或 pk_test_）。不是密钥——但持有它就能针对你的项目创建账单。取自项目的激活 payment key |
pid |
项目标识（前缀 prj_）。决定加载哪些代币、网络和品牌 |
URL 不绑定设备——在任何浏览器设备上打开。每次打开都是独立会话。
一笔销售怎么走
- 01收银员在浏览器中打开终端 URL（手机或平板）。
- 02选择法币（USD、EUR、RUB，外加 43 种），在数字键盘上输入金额。
- 03点付款——终端创建账单并打开标准付款页。
- 04客户用自己的设备付款：扫终端屏幕上的 QR 码，或打开链接。
- 05链上确认后，终端自动回到数字键盘。
收银员全程不碰钱包。客户无需注册 Paymos。大部分等待花在链上确认上——快速最终性链上几秒，慢链上的大额付款几分钟。
自定义外观
Terminal 继承与常规收银台页面相同的品牌设置。在收银表单页面的品牌卡片中编辑：
| 设置 | 影响 |
|---|---|
| 收银台样式 | 付款页的基础样式模板（背景图案、主题） |
| 强调色 | 主色：按钮、链接、悬停、当前网络指示 |
| 背景色 | 页面背景 |
| 表面色 | 卡片和面板表面 |
| 文字色 | 正文主文字 |
| 弱化色 | 次要文字（提示、说明） |
| 圆角 | 按钮和卡片圆角，0-32px |
保存后，同页的收银台预览立即更新。Terminal 在下次打开时应用变更。
Logo
项目 Logo 自动显示在终端头部。它是上传的文件，不是外部图片地址：在项目详情页打开项目，点项目名旁边的方块选图。仅支持 PNG、JPEG 和 WebP，单个文件最大 2 MB。SVG 传不上去。
币种列表
Terminal 展示项目详情页 币种 标签下启用的法币。默认零售组合为 USD、EUR、RUB。按你的地域增减。
启用的网络和代币
Terminal 只向客户展示项目 币种 标签 中启用的网络和代币。典型的零售组合：
- Tron（USDT）——独联体和亚洲客户
- Polygon（USDC/USDT）——客户手续费低
- BSC（USDT）——币安生态用户
- TON——Telegram 原生用户群
预期会有大额销售时保持以太坊主网启用。
沙箱 vs 生产
终端 URL 的 key 前缀决定环境——pk_test_ 为沙箱，pk_live_ 为生产。跑在沙箱里时，终端顶部显示一条沙盒横幅。
测试步骤：
- 在 控制台 → 开发者 → API 密钥 生成
pk_test_key。 - 拼出沙箱终端 URL（同样的结构，测试 key）。
- 用测试网钱包支付账单。
上线时创建 pk_live_ key 并更新收银设备上的 URL。
Terminal 作为 Low-Code SDK 的回退
如果你用 Low-Code SDK 且不设固定金额（省略 amount），把终端 URL 传给 SDK 的 pos_url 选项——挂件就会打开终端而不是标准收银台表单。一个挂件覆盖两种流程：
- 固定金额——客户通过标准表单支付设定金额。
- 自由金额——客户在终端数字键盘上输入金额。
一个脚本，两种模式，无需单独构建。没有 pos_url 就没有回退：无金额可解析的点击会发出 paymos:error 事件，而不是打开终端。
多收银员或多设备
URL 是共享的。在任意多台设备上打开——它们并行跑在同一个项目上。交易汇入项目的共享历史，控制台一览无遗。
不内置按收银员归因。 如果需要，按收银台或按门店各建一个项目。每个项目有自己的 URL、自己的历史、自己的控制台汇总。
多门店
按门店建项目：
- 控制台 → 项目 → 新建项目，集成方式选「收银终端」。
- 配置品牌和启用的网络。
- 在收银终端页面复制该门店的 URL。
所有项目在同一个商户账户下——报表汇总到共享控制台。
安全
URL 中的 key 是公开 key。它不授予转出、项目设置或任何受限操作的权限。它授予的仅是针对你的项目创建账单的能力。
实际含义：
- 终端 URL 可以放心存在公共收银设备的浏览器书签里。
- 如果 URL 泄露给外人，他们可以创建账单（但不能替你付款，也不能转出资金）。
- 如果失陷，在 控制台 → 开发者 → API 密钥 生成新的
pk_live_key 并更新 URL，然后吊销旧 key。
Secret key（sk_live_）从不出现在终端中。它们只用于服务端 API 请求。
故障排查
终端打不开
依次检查：
- URL 里
key和pid都在，一个都没漏。 - 项目的集成方式是「收银终端」——别的方式建的项目打不开这个地址。
- key 没有在 控制台 → 开发者 → API 密钥 中被吊销。
页面提示「暂无法付款」
链接没解析成功的几种原因，页面用同一个提示打发：key 抄错或已被吊销、pid 不对、项目的集成方式不是「收银终端」。先到收银终端页面重新复制一次 URL；如果那里压根没有 URL 可复制，原因就是集成方式——给这台收银设备单独建一个项目。
点「付款」后 QR 码不出现
检查项目 币种 中是否至少启用了一个代币。
付款不确认
确认深度取决于网络和付款金额——小额快速清算，大额要等待更久的最终性。原生最终性快的链（BSC、Polygon、Solana、Avalanche、Plasma）几秒内结算；Tron、以太坊和各 L2 上的大额可能要几分钟。如果客户几分钟前已付款而页面没有变化，在该网络的区块浏览器中打开交易，确认它已上链。
改主题后终端显示异常
旧主题仍缓存在已打开的标签页里。关掉标签页重新打开 URL 即可拉取新主题。