## 在线支付 (`payments`)

发起在线充值:建一张待支付订单并向支付网关预下单,返回付款地址。

鉴权: 用户 · 文档: https://www-sa2.kuxitong.com/zh/docs/api/payments

### GET `/api/v2/payments/usdt/orders/{id}`

查看 USDT 订单 · 鉴权: 用户

```sh
curl "https://panel.example.com/api/v2/payments/usdt/orders/{id}" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### POST `/api/v2/payments/usdt/orders/{id}/check`

我已转账 · 鉴权: 用户

```sh
curl -X POST "https://panel.example.com/api/v2/payments/usdt/orders/{id}/check" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### POST `/api/v2/payments/{provider}/orders`

发起在线支付 · 鉴权: 用户

请求体:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `amount_cents` | integer | 有 | 充值金额(分),1 ~ 1000000000000(单笔上限,与后端 account.MaxAmount 一致)。USDT 另有单笔上限:按汇率折出不超过 2^40 个 0.0001 USDT(约 1.09 亿 USDT),超出回 422(/amount_cents range,文案说明是 USDT 单笔上限)。 |
| `intent` | PaymentIntent |  | 办理意图(在线付差额):到账入余额后由服务端按它办理(同键调购买/续费/更换/加购接口),不靠浏览器开着。下单时先按原请求体试算,试算不过原样回该错误;试算应付与币种记作报价快照,到账时价格变了、报价过期(付款晚于网关单 2 小时 / USDT 单过期时间)或办理失败都不办理,钱留余额,订单 data.intent.state=failed 并写明 code/reason,发站内信。办理结果见订单 data.intent。 |

```sh
curl -X POST "https://panel.example.com/api/v2/payments/{provider}/orders" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

在线支付对象:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `address` | string |  | 收款地址(TRC20)。 |
| `amount` | string |  | 应付 USDT(4 位小数,含区分订单的尾数),须一分不差地转。 |
| `amount_cents` | integer | 有 | 充值金额(分),1 ~ 1000000000000(单笔上限,与后端 account.MaxAmount 一致)。USDT 另有单笔上限:按汇率折出不超过 2^40 个 0.0001 USDT(约 1.09 亿 USDT),超出回 422(/amount_cents range,文案说明是 USDT 单笔上限)。 |
| `chain_error` | string |  | 本次没查成链的已知原因(仅 checked=false 时可能有);auth = 链上查询服务拒绝了平台的 API Key,需管理员处理。无此字段 = 查成了、被节流或瞬时失败。 可选值: ["auth"] |
| `checked` | boolean |  | 本次确实查了链;false = 节流内(同租户 15 秒、同地址 5 秒)或查链失败,状态照旧。 |
| `created_at` | string |  | 下单时间;与 expires_at 一起给出订单完整有效期,供进度条按总时长算。 |
| `credited_order_id` | integer |  | 到账转人工补入后另生成的已付款充值单 ID(仅人工补入才有);有值时实际入账金额以余额明细为准,可能与下单金额不同。 |
| `currency` | string |  | 账户币种。 |
| `expires_at` | string |  | 有效期截止;过期后到账不自动入账,进到账表待管理员处理。 |
| `gateway` | string |  | 实际下单的支付网关。 可选值: ["alipay","wxpay","codepay","epay","usdt"] |
| `intent` | PaymentIntent |  | 办理意图(在线付差额):到账入余额后由服务端按它办理(同键调购买/续费/更换/加购接口),不靠浏览器开着。下单时先按原请求体试算,试算不过原样回该错误;试算应付与币种记作报价快照,到账时价格变了、报价过期(付款晚于网关单 2 小时 / USDT 单过期时间)或办理失败都不办理,钱留余额,订单 data.intent.state=failed 并写明 code/reason,发站内信。办理结果见订单 data.intent。 |
| `mch_order_no` | string |  | 充值单号。 |
| `order_id` | integer |  | 充值单 ID。 |
| `pay_url` | string |  | 付款地址:跳转网址,或微信 weixin:// 与支付宝当面付的二维码串;USDT 为 tron:<收款地址>。 |
| `rate` | string |  | 下单锁定的汇率:1 USDT = rate 账户币种。 |
| `server_time` | string |  | 服务器当前时间;前端按它与浏览器时钟的偏移算倒计时与过期态,不信浏览器时钟。 |
| `status` | string |  | unpaid = 等待转账;paid = 已到账入余额;expired = 已过期。 可选值: ["unpaid","paid","expired"] |
| `txid` | string |  | 入账的链上交易号(已付款才有)。 |
| `usdt` | UsdtPay |  | USDT 订单的收款要素。 |
