# 選擇網路或付款通道 

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

[請求範例 ↓](https://epusdt.com/zh-tw/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-tw/api/endpoints/config)
* [商戶回呼](https://epusdt.com/zh-tw/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"
}
```
