# Create an EPay order 

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

[Request example ↓](https://epusdt.com/api/endpoints/epay-order#request-example)

Send signed parameters as a GET query or POST form. With a valid MD5 signature the gateway redirects to checkout with HTTP 302.

## Parameters 

| Field          | Location   | Type   | Required | Description                                          |
| -------------- | ---------- | ------ | -------- | ---------------------------------------------------- |
| pid            | query/form | string | Yes      | Merchant PID. Use a numeric PID for callbacks.       |
| money          | query/form | number | Yes      | Fiat amount.                                         |
| out\_trade\_no | query/form | string | Yes      | Merchant order ID.                                   |
| notify\_url    | query/form | string | Yes      | Merchant callback URL.                               |
| return\_url    | query/form | string | No       | Browser return URL.                                  |
| name           | query/form | string | No       | Product or order name.                               |
| type           | query/form | string | No       | Empty, alipay, or an enabled token.network selector. |
| token          | query/form | string | No       | Requested token when no selector matched.            |
| network        | query/form | string | No       | Requested network when no selector matched.          |
| currency       | query/form | string | No       | Overrides the EPay currency default.                 |
| sign           | query/form | string | Yes      | EPay MD5 signature.                                  |
| sign\_type     | query/form | string | No       | Typically MD5.                                       |

The sample signature uses the demonstration key `epusdt_secret_key`. Recalculate it on your server whenever the fields or merchant key change.

## Related resources 

* [Return to the merchant](https://epusdt.com/api/endpoints/checkout-return)
* [Signatures](https://epusdt.com/api/payment#signing)

## Responses

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

application/jsonResponse fields
* `status_code` integer  
Application result code.
* `message` string  
Human-readable result.
* `data` null  
Response payload; null on error.
* `request_id` string  
Request identifier for tracing.

application/jsonResponse fields
* `status_code` integer  
Application result code.
* `message` string  
Human-readable result.
* `data` null  
Response payload; null on error.
* `request_id` string  
Request identifier for tracing.

application/jsonResponse fields
* `status_code` integer  
Application result code.
* `message` string  
Human-readable result.
* `data` null  
Response payload; null on error.
* `request_id` string  
Request identifier for tracing.

application/jsonResponse fields
* `status_code` integer  
Application result code.
* `message` string  
Human-readable result.
* `data` null  
Response payload; null on error.
* `request_id` string  
Request identifier for tracing.

application/jsonResponse fields
* `status_code` integer  
Application result code.
* `message` string  
Human-readable result.
* `data` null  
Response payload; null on error.
* `request_id` string  
Request identifier for tracing.

application/jsonResponse fields
* `status_code` integer  
Application result code.
* `message` string  
Human-readable result.
* `data` null  
Response payload; null on error.
* `request_id` string  
Request identifier for tracing.

application/jsonResponse fields
* `status_code` integer  
Application result code.
* `message` string  
Human-readable result.
* `data` null  
Response payload; null on error.
* `request_id` string  
Request identifier for tracing.

application/jsonResponse fields
* `status_code` integer  
Application result code.
* `message` string  
Human-readable result.
* `data` null  
Response payload; null on error.
* `request_id` string  
Request identifier for tracing.

application/jsonResponse fields
* `status_code` integer  
Application result code.
* `message` string  
Human-readable result.
* `data` null  
Response payload; null on error.
* `request_id` string  
Request identifier for tracing.

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

**Request example**GETPOST

Gateway URL 

```
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'
```

**Example response**302 · Redirect401 · Invalid signature400 · 10009 · Invalid parameters400 · 10041 · Invalid notification URL400 · 10002 · Order already exists400 · 10004 · Amount below payment precision400 · 10014 · Network disabled400 · 10016 · Asset not found400 · 10003 · No available receiving address400 · 10005 · No available address/amount combination

Location

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