API 文档

了解 Paymos 商户 API：账单、代币余额、签名 webhook，以及在 11 个转出网络上向白名单钱包转出。

创建项目，在沙盒中跑通账单与带签名的 webhook，然后创建正式凭据，接收第一笔主网真实付款。

跟随一张账单从创建、选币、付款检测、确认、过期，到你的系统消费的最终 webhook。

用专用测试密钥、签名 webhook 和不动真实资金的模拟端点，测试账单与转出的状态变化。

用 HMAC-SHA256 认证每个 Merchant API 请求：必需请求头、规范化载荷构造、时间戳与防重放保护。

创建 Payment 或 Payout API 密钥，了解其作用域与前缀，安全轮换凭证，并隔离测试与正式访问。

测试与正式请求共用一个 Paymos Merchant API base URL，通过密钥前缀选择环境，保持一条集成路径。

在项目启用资产前，先确认 13 个区块链网络中哪些支持 USDT、USDC、USD1、DAI 和黄金锚定的 XAUT。

一致地处理 Merchant API 错误：响应封装、HTTP 状态分组、机器可读错误码、请求限制与重试指引。

用稳定的机器可读错误码处理 Merchant API 失败，含字段级校验明细和文档化的恢复路径。

读一次 Paymos 服务器时间，算出与自己服务器的偏移，之后在本地补上再签名。GET /v1/time 是公开端点，不需要 API key，也不需要 HMAC 签名，返回 Unix 秒级时间戳。

创建账单以接收加密货币付款。两种流程：直接加密货币（代币和网络固定）与法币（客户在托管收银台选择代币）。

按严格的状态和日期筛选条件列出账单，用游标分页向前翻页，对账不产生重复页。

从自定义收银台为法币或代币计价的账单确认代币和网络，然后展示返回的充值地址与付款信息。

按 ID 获取单个账单，查看付款与确认状态，并用你自己的外部订单号完成对账。

在客户锁定资产之前取消未完成的账单，了解允许的状态迁移，并处理取消响应。

让沙箱账单走完一个付款结果，测试与真实链上转账确认相同的生命周期和 webhook。

从代币余额向白名单钱包创建转出，选择付款网络，签名请求，并跟踪其状态。

按严格筛选条件列出转出，用游标分页向前翻页，核对目标网络，可靠地对账转账历史。

按 ID 获取一笔转出，查看其当前状态和交易引用，并配合签名 webhook 完成对账。

在交易签名开始前取消待处理的转出，了解哪些状态允许取消，并处理更新后的响应。

不广播交易即可完成待处理的沙箱转出，端到端验证付款 webhook。

查询可用代币余额：按币种而非来源网络读取金额，并在创建转出前使用该结果。

为单个付款人创建可重复使用的收款身份，以你自己的外部标识为键，每条支持的网络配一个永久地址。

以最新在前的顺序用游标翻阅你的收款通道，并按项目、状态或你自己的外部标识筛选。

读取单个收款通道：每条网络的永久地址、该网络此刻接受的代币，以及你现行的费率。

停止把新的充值计入某个收款通道，同时不删除记录、不释放地址、不影响已经收到的付款。

让收款通道重新接收充值；服务端按它是否已有地址，把它置回 active 或 provisioning。

按发布顺序轮询已确认的收款通道充值，游标只向前推进，任何一笔已结算的付款都不会被跳过或重复。

读取任意状态下的单条收款通道充值，含冻结的费率快照、总额手续费与实收金额，以及它的链上凭据。

把沙箱的收款通道充值推到 confirming、reorged 或 confirmed，并收到与真实链上付款相同的 webhook。

用签名的、按环境隔离的 webhook 端点和完整的投递工作流，把 Paymos 接入你的后端。

处理全部 16 种 Paymos webhook 事件类型，显式读取资源状态和终态语义。

读取带版本的 webhook 信封，以及 data 中完整的账单、转出或通道充值资源快照。

用 HMAC-SHA256 验证 X-Webhook-Signature 请求头，安全比较签名，执行时间戳规则，并支持密钥轮换。

按约 16 小时内 11 次投递尝试设计，对重复事件去重，检查失败并在恢复后重放。

在交互式文档演练场中走通真实的沙箱账单和 webhook 投递路径。

为 WooCommerce 安装官方 Paymos 插件，安全连接项目凭证，测试结账流程，并通过带签名的 webhook 更新订单。

为 WHMCS 账单添加稳定币付款，无需填写密钥即可连接 Paymos，测试 webhook，并保留现有的开通规则。

为 OpenCart 安装官方 Paymos 扩展，无需复制 secret 即可连接店铺，并在测试模式下验证付款状态更新。

将 Paymos 接入 Easy Digital Downloads，测试稳定币订单，验证带签名的付款更新，并在确认后才释放文件。

为 CS-Cart 和 Multi-Vendor 安装官方 Paymos 扩展，连接项目，验证带签名的状态更新，并在上线前测试一笔订单。

为 Magento 2 或 Adobe Commerce 安装 Paymos 模块，连接测试与正式凭证，并验证订单到账单的状态流转。

为 Shopware 6 安装 Paymos 插件，按销售渠道启用，验证带签名的交易更新，无需重装即可切换模式。

为 PrestaShop 8 或 9 添加 Paymos，安装模块并一键连接店铺，验证带签名的回调，并测试 Payment accepted 订单流转。

将客户重定向到托管收银台，或以受限 iframe 嵌入付款页，然后依据带签名的确认 webhook 履约订单。

给任何网页添加可配置的支付按钮，自选金额来源和主题，无需搭建后端表单即可打开 Paymos 收银台。

把项目链接当作手机或平板上的面对面加密货币收银终端：输入金额、出示 QR 码、跟踪确认。

使用官方 Paymos 商户 API 客户端：JavaScript/TypeScript、Python、PHP、Go、.NET、Java、Ruby 和 Rust，带类型化请求与 HMAC 签名。

了解 Paymos 如何用隔离的转出签名、目标地址白名单、HMAC 认证、签名 webhook、SSRF 防护和审计记录保护代币余额。