# 选择网络或支付通道 

**POST**`https://pay.example.com/pay/switch-network`

[请求示例 ↓](https://epusdt.com/zh/api/endpoints/switch-network#request-example)

JSON 请求体必须包含父订单的 `trade_id`、`token` 和 `network`。父订单须处于状态 1 或 4。使用响应中的地址或托管支付链接。

## JSON 请求体 

| 必填字段      | 类型     | 示例                      |
| --------- | ------ | ----------------------- |
| trade\_id | string | 20260523171652123456001 |
| token     | string | USDT                    |
| network   | string | tron                    |

## 相关文档 

* [获取收银台配置](https://epusdt.com/zh/api/endpoints/config)
* [商户回调](https://epusdt.com/zh/api/payment#callbacks)

## 响应

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` object  
接口返回的数据，失败时为 null。

  * `trade_id` string
  * `amount` number
  * `actual_amount` number
  * `token` string
  * `currency` string
  * `network` string
  * `status` integer
  * `expiration_time` integer
  * `is_selected` boolean
* `request_id` string  
请求标识，可用于排查日志。

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` null  
接口返回的数据，失败时为 null。
* `request_id` string  
请求标识，可用于排查日志。

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` null  
接口返回的数据，失败时为 null。
* `request_id` string  
请求标识，可用于排查日志。

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` null  
接口返回的数据，失败时为 null。
* `request_id` string  
请求标识，可用于排查日志。

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` null  
接口返回的数据，失败时为 null。
* `request_id` string  
请求标识，可用于排查日志。

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` null  
接口返回的数据，失败时为 null。
* `request_id` string  
请求标识，可用于排查日志。

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` null  
接口返回的数据，失败时为 null。
* `request_id` string  
请求标识，可用于排查日志。

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` null  
接口返回的数据，失败时为 null。
* `request_id` string  
请求标识，可用于排查日志。

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` null  
接口返回的数据，失败时为 null。
* `request_id` string  
请求标识，可用于排查日志。

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` null  
接口返回的数据，失败时为 null。
* `request_id` string  
请求标识，可用于排查日志。

application/json响应字段
* `status_code` integer  
业务结果码，商户可据此判断具体原因。
* `message` string  
便于阅读的结果说明。
* `data` null  
接口返回的数据，失败时为 null。
* `request_id` string  
请求标识，可用于排查日志。

[error-codes.json ↓](https://epusdt.com/agent-setup/error-codes.json)

**请求示例**

网关地址 

```
curl -i -X POST \
  'https://pay.example.com/pay/switch-network' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "trade_id": "20260523171652123456001",
  "token": "USDT",
  "network": "tron"
}'
```

**响应示例**200 · 成功400 · 10009 · 无法解析参数400 · 10008 · 订单不存在400 · 10011 · 超过子订单数量上限400 · 10012 · 不能对子订单切换网络400 · 10013 · 订单不是等待支付状态400 · 10016 · 支持的资产不存在400 · 10017 · 支付服务商未启用400 · 10018 · 支付服务商配置不完整400 · 10019 · 支付服务商不支持该币种或网络400 · 10042 · 支付服务商创建订单失败

application/json · 响应字段节选

```
{
  "status_code": 200,
  "message": "success",
  "data": {
    "trade_id": "20260523171652123456001",
    "amount": 100,
    "actual_amount": 14.29,
    "token": "USDT",
    "currency": "CNY",
    "network": "tron",
    "status": 1,
    "expiration_time": 1779530812000,
    "is_selected": false
  },
  "request_id": "b1344d70-ff19-4543-b601-37abfb3b3686"
}
```
