# 创建易支付订单 

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

[请求示例 ↓](https://epusdt.com/zh/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/api/endpoints/checkout-return)
* [签名规则](https://epusdt.com/zh/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
```
