跳到正文

API

本页内容

确认

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

POST/v1/invoices/:invoice_id/confirm-payment

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 客户选择支付的稳定币(如 USDTUSDC)。必须已在该账单所属项目上启用
network string 客户选择支付的网络(如 TRC20BASE)——必须是该代币已启用的网络
{
  "currency": "USDT",
  "network": "TRC20"
}

响应(200 OK)

返回完整账单,其 payment 部分现已填充——所选的 currency / network、分配的充值 address、法币计价时锁定的 exchange_rate,以及预期加密货币数量 expected。由于本调用用你的商户密钥认证,响应还会携带仅商户可见的 feenet 字段。响应体结构与查询账单相同。

错误

完整目录见错误码。每个错误响应中的 type URI 会深链到对应的行。确认不属于你的账单返回 404expiredcancelled 账单返回 410;越过 awaiting_client 的其他所有状态返回 409——包括终态 paidpaid_overunderpaid