# 建立易支付訂單 

**POST**`https://pay.example.com/payments/epay/v1/order/create-transaction/submit.php`

[請求範例 ↓](https://epusdt.com/zh-tw/api/endpoints/epay-order#request-example)

透過 GET 查詢字串或 POST 表單提交已簽章的參數。MD5 驗章並成功建立訂單後，閘道透過 HTTP 302 導向收銀台。

## 請求參數 

| 欄位             | 位置         | 型別     | 必填 | 說明                                                                          |
| -------------- | ---------- | ------ | -- | --------------------------------------------------------------------------- |
| pid            | query/form | string | 是  | 商戶 PID。建議使用數字 PID；EPay 回撥會按數字 PID 輸出。                                       |
| money          | query/form | number | 是  | 法幣金額。                                                                       |
| out\_trade\_no | query/form | string | 是  | 商戶訂單號。                                                                      |
| notify\_url    | query/form | string | 是  | 非同步回撥地址。                                                                    |
| return\_url    | query/form | string | 否  | 支付完成後的同步跳轉地址。                                                               |
| name           | query/form | string | 否  | 商品/訂單名稱。                                                                    |
| type           | query/form | string | 否  | 僅支援空值、alipay，或當前已啟用並可收款的 token.network selector（如 usdt.tron）。推薦使用小寫 alipay。 |
| token          | query/form | string | 否  | 可選收款幣種。僅在 type 不是命中的 selector 時參與解析；傳了就必須參與 EPay 簽名。                        |
| network        | query/form | string | 否  | 可選收款網路。僅在 type 不是命中的 selector 時參與解析；傳了就必須參與 EPay 簽名。                        |
| currency       | query/form | string | 否  | 可選法幣幣種。優先順序高於後臺 epay.default\_currency；傳了就必須參與 EPay 簽名。                     |
| sign           | query/form | string | 是  | EPay 簽名。                                                                    |
| sign\_type     | query/form | string | 否  | 通常為 MD5。                                                                    |

範例使用示範金鑰 `epusdt_secret_key` 簽章。變更參數或商戶金鑰後，請在伺服器重新簽章。

## 相關文件 

* [返回商戶網站](https://epusdt.com/zh-tw/api/endpoints/checkout-return)
* [簽章規則](https://epusdt.com/zh-tw/api/payment#signing)

## 回應

Location`Location: /pay/checkout-counter/20260523171652123456001`

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)

**請求範例**GETPOST

閘道網址 

```
curl -i -X POST \
  'https://pay.example.com/payments/epay/v1/order/create-transaction/submit.php' \
  -H 'Content-Type: application/x-www-form-urlencoded' \
  --data-raw 'pid=1000&money=100&out_trade_no=ORD202605230001&notify_url=https%3A%2F%2Fmerchant.example%2Fnotify&return_url=https%3A%2F%2Fmerchant.example%2Freturn&name=VIP&type=alipay&sign=b865b0acbb2b01554c35a1bd33351452&sign_type=MD5'
```

**回應範例**302 · 重新導向401 · 簽名認證錯誤400 · 10009 · 無法解析引數400 · 10041 · 通知地址無效400 · 10002 · 支付交易已存在，請勿重複建立400 · 10004 · 支付金額有誤，無法滿足最小支付單位400 · 10014 · 鏈未啟用400 · 10016 · 支援的資產不存在400 · 10003 · 無可用錢包地址，無法發起支付400 · 10005 · 無可用金額通道

Location

```
Location: /pay/checkout-counter/20260523171652123456001
```
