本页内容
确认
从自定义收银台为法币或代币计价的账单确认代币和网络,然后展示返回的充值地址与付款信息。
API 密钥: Payment
为仍处于 awaiting_client 的账单确认稳定币和网络。无论账单按法币还是按代币计价,这次调用都会分配充值地址并把账单推进到 awaiting_payment。法币计价的账单在同一刻还会锁定汇率;按代币计价的账单没有汇率可锁——确认的代币必须与创建时请求的一致,若创建时固定了网络,网络也必须一致。
当你渲染自己的收银台、在服务器端收集代币选择时使用本接口。由 Paymos 自己提供的付款界面——payment_url 指向的托管页面、iframe 嵌入、Low-Code SDK,以及 Telegram 机器人项目中 payment_url 转而打开的 Paymos 机器人——会自行确认选择,你不必为它们调用本端点。本端点不区分项目渠道:Telegram 机器人项目同样可以在服务器端确认,付款人打开链接后直接看到充值地址,不再出现选择步骤。
这里给你的是一个端点,不是一套贴你品牌的成品。它让你在自己的域名上自建付款页,但不改变 Paymos 托管的页面:那些页面在任何主题、任何嵌入方式下都保留 "Secured by Paymos" 页脚,Paymos 也不提供绑到你自己域名的付款页。
请求体
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
currency |
string | 是 | 客户选择支付的稳定币(如 USDT、USDC)。必须已在该账单所属项目上启用 |
network |
string | 是 | 客户选择支付的网络(如 TRC20、BASE)——必须是该代币已启用的网络 |
{
"currency": "USDT",
"network": "TRC20"
}
响应(200 OK)
返回完整账单,其 payment 部分现已填充——所选的 currency / network、分配的充值 address、法币计价时锁定的 exchange_rate,以及预期加密货币数量 expected。由于本调用用你的商户密钥认证,响应还会携带仅商户可见的 fee 和 net 字段。响应体结构与查询账单相同。
错误
完整目录见错误码。每个错误响应中的 type URI 会深链到对应的行。确认不属于你的账单返回 404。expired 或 cancelled 账单返回 410;越过 awaiting_client 的其他所有状态返回 409——包括终态 paid、paid_over 和 underpaid。