## 支付通道 (`payment-channels`)

管理员配置支付方式走哪家网关及各网关商户参数;密钥只写不回显。

鉴权: 仅管理员 · 文档: https://www-sa2.kuxitong.com/zh/docs/api/payment-channels

### GET `/api/v2/payment-channels`

支付通道设置 · 鉴权: 仅管理员

```sh
curl "https://panel.example.com/api/v2/payment-channels" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### PUT `/api/v2/payment-channels`

修改支付通道 · 鉴权: 仅管理员

请求体:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `alipay` | AlipayGateway |  | 支付宝网关的商户参数。 |
| `codepay` | CodepayGateway |  | 码支付网关的商户参数。 |
| `default_method` | string |  | 充值页默认选中的方式;transfer = 转账汇款(须已开启转账)。 可选值: ["","alipay","wxpay","usdt","transfer"] |
| `epay` | EpayGateway |  | 易支付网关的商户参数。 |
| `methods` | PaymentMethodSet |  | 各在线支付方式的开关与所走网关。 |
| `notify_base` | string |  | 面板对网关可达的根地址(如 https://panel.example.com);回调地址由它拼出,空 = 不能下单。 |
| `return_url` | string |  | 付款后跳回的页面(支付宝电脑网站支付、易支付用);空 = 不跳。 |
| `transfer` | PaymentTransfer |  | 线下转账设置。 |
| `usdt` | UsdtConf |  | USDT(TRC20)收款参数。 |
| `wxpay` | WxpayGateway |  | 微信支付网关的商户参数。 |

```sh
curl -X PUT "https://panel.example.com/api/v2/payment-channels" \
  -H "X-API-Key: $GOCDN_API_KEY"
```

### POST `/api/v2/payment-channels/usdt-rate`

立即获取 USDT 汇率 · 鉴权: 仅管理员

请求体:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `currency` | string | 有 | 币种代码。 |
| `markup_pct` | string |  | 上浮百分数(-50~100,可带小数),空 = 0。 |
| `source` | string | 有 | 行情源:CNY 用 okx/binance(C2C),USD 用 coinbase/kraken,其他币种用 usd(经 USD 换算)。 可选值: ["okx","binance","coinbase","kraken","usd"] |

```sh
curl -X POST "https://panel.example.com/api/v2/payment-channels/usdt-rate" \
  -H "X-API-Key: $GOCDN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"currency":"CNY","markup_pct":"1.5","source":"okx"}'
```

支付通道对象:

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `alipay` | AlipayGateway |  | 支付宝网关的商户参数。 |
| `codepay` | CodepayGateway |  | 码支付网关的商户参数。 |
| `currency` | string | 有 | 币种代码。 |
| `default_method` | string |  | 充值页默认选中的方式;transfer = 转账汇款(须已开启转账)。 可选值: ["","alipay","wxpay","usdt","transfer"] |
| `epay` | EpayGateway |  | 易支付网关的商户参数。 |
| `market` | string |  | 取到的行情:1 USDT = market 该币。 |
| `markup_pct` | string |  | 上浮百分数(-50~100,可带小数),空 = 0。 |
| `methods` | PaymentMethodSet |  | 各在线支付方式的开关与所走网关。 |
| `notify_base` | string |  | 面板对网关可达的根地址(如 https://panel.example.com);回调地址由它拼出,空 = 不能下单。 |
| `rate` | string |  | 按上浮算出的汇率。 |
| `return_url` | string |  | 付款后跳回的页面(支付宝电脑网站支付、易支付用);空 = 不跳。 |
| `source` | string | 有 | 行情源:CNY 用 okx/binance(C2C),USD 用 coinbase/kraken,其他币种用 usd(经 USD 换算)。 可选值: ["okx","binance","coinbase","kraken","usd"] |
| `transfer` | PaymentTransfer |  | 线下转账设置。 |
| `updated_at` | string |  | 取值时间(服务端时间);保存设置时采用这份草稿,该行的更新时间就是它。 |
| `usdt` | UsdtConf |  | USDT(TRC20)收款参数。 |
| `wxpay` | WxpayGateway |  | 微信支付网关的商户参数。 |
