# Tạo đơn EPay 

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

[Ví dụ yêu cầu ↓](https://epusdt.com/vi/api/endpoints/epay-order#request-example)

Gửi các tham số đã ký qua truy vấn GET hoặc biểu mẫu POST. Sau khi xác minh MD5 và tạo đơn, cổng trả HTTP 302 đến trang thanh toán.

## Tham số 

| Trường         | Địa điểm                     | Kiểu  | Bắt buộc | Mô tả                                                            |
| -------------- | ---------------------------- | ----- | -------- | ---------------------------------------------------------------- |
| pid            | Chuỗi truy vấn hoặc biểu mẫu | Chuỗi | Có       | ID của người bán hàng. Sử dụng PID số cho các phản hồi.          |
| money          | Chuỗi truy vấn hoặc biểu mẫu | Số    | Có       | Số tiền (được chỉ định).                                         |
| out\_trade\_no | Chuỗi truy vấn hoặc biểu mẫu | Chuỗi | Có       | Mã đơn hàng của người bán.                                       |
| notify\_url    | Chuỗi truy vấn hoặc biểu mẫu | Chuỗi | Có       | URL nhận callback của người bán.                                 |
| return\_url    | Chuỗi truy vấn hoặc biểu mẫu | Chuỗi | Không    | Trang web được trả về bởi trình duyệt.                           |
| name           | Chuỗi truy vấn hoặc biểu mẫu | Chuỗi | Không    | Tên sản phẩm hoặc đơn hàng.                                      |
| type           | Chuỗi truy vấn hoặc biểu mẫu | Chuỗi | Không    | Trống, alipay, hoặc một trình chọn token.network được kích hoạt. |
| token          | Chuỗi truy vấn hoặc biểu mẫu | Chuỗi | Không    | Yêu cầu token khi không có trình chọn nào khớp.                  |
| network        | Chuỗi truy vấn hoặc biểu mẫu | Chuỗi | Không    | Yêu cầu kết nối khi không tìm thấy trình chọn nào.               |
| currency       | Chuỗi truy vấn hoặc biểu mẫu | Chuỗi | Không    | Làm thế để thay đổi cài đặt tiền tệ mặc định của EPay.           |
| sign           | Chuỗi truy vấn hoặc biểu mẫu | Chuỗi | Có       | Chữ ký MD5 của EPay.                                             |
| sign\_type     | Chuỗi truy vấn hoặc biểu mẫu | Chuỗi | Không    | Thông thường, MD5.                                               |

Chữ ký mẫu dùng khóa minh họa `epusdt_secret_key`. Tính lại trên máy chủ khi thay đổi tham số hoặc khóa.

## Tài liệu liên quan 

* [Quay về trang người bán](https://epusdt.com/vi/api/endpoints/checkout-return)
* [Quy tắc ký](https://epusdt.com/vi/api/payment#signing)

## Phản hồi

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

application/jsonTrường phản hồi
* `status_code` integer  
Mã kết quả nghiệp vụ.
* `message` string  
Thông báo kết quả.
* `data` null  
Dữ liệu trả về; null khi có lỗi.
* `request_id` string  
Mã yêu cầu dùng để tra cứu nhật ký.

application/jsonTrường phản hồi
* `status_code` integer  
Mã kết quả nghiệp vụ.
* `message` string  
Thông báo kết quả.
* `data` null  
Dữ liệu trả về; null khi có lỗi.
* `request_id` string  
Mã yêu cầu dùng để tra cứu nhật ký.

application/jsonTrường phản hồi
* `status_code` integer  
Mã kết quả nghiệp vụ.
* `message` string  
Thông báo kết quả.
* `data` null  
Dữ liệu trả về; null khi có lỗi.
* `request_id` string  
Mã yêu cầu dùng để tra cứu nhật ký.

application/jsonTrường phản hồi
* `status_code` integer  
Mã kết quả nghiệp vụ.
* `message` string  
Thông báo kết quả.
* `data` null  
Dữ liệu trả về; null khi có lỗi.
* `request_id` string  
Mã yêu cầu dùng để tra cứu nhật ký.

application/jsonTrường phản hồi
* `status_code` integer  
Mã kết quả nghiệp vụ.
* `message` string  
Thông báo kết quả.
* `data` null  
Dữ liệu trả về; null khi có lỗi.
* `request_id` string  
Mã yêu cầu dùng để tra cứu nhật ký.

application/jsonTrường phản hồi
* `status_code` integer  
Mã kết quả nghiệp vụ.
* `message` string  
Thông báo kết quả.
* `data` null  
Dữ liệu trả về; null khi có lỗi.
* `request_id` string  
Mã yêu cầu dùng để tra cứu nhật ký.

application/jsonTrường phản hồi
* `status_code` integer  
Mã kết quả nghiệp vụ.
* `message` string  
Thông báo kết quả.
* `data` null  
Dữ liệu trả về; null khi có lỗi.
* `request_id` string  
Mã yêu cầu dùng để tra cứu nhật ký.

application/jsonTrường phản hồi
* `status_code` integer  
Mã kết quả nghiệp vụ.
* `message` string  
Thông báo kết quả.
* `data` null  
Dữ liệu trả về; null khi có lỗi.
* `request_id` string  
Mã yêu cầu dùng để tra cứu nhật ký.

application/jsonTrường phản hồi
* `status_code` integer  
Mã kết quả nghiệp vụ.
* `message` string  
Thông báo kết quả.
* `data` null  
Dữ liệu trả về; null khi có lỗi.
* `request_id` string  
Mã yêu cầu dùng để tra cứu nhật ký.

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

**Ví dụ yêu cầu**GETPOST

URL cổng thanh toán 

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

**Ví dụ phản hồi**302 · Chuyển hướng401 · Chữ ký không hợp lệ400 · 10009 · Tham số không hợp lệ400 · 10041 · URL thông báo không hợp lệ400 · 10002 · Đơn hàng đã tồn tại400 · 10004 · Số tiền dưới mức chính xác thanh toán400 · 10014 · Mạng không hoạt động400 · 10016 · Tài sản không được tìm thấy.400 · 10003 · Không có địa chỉ nhận được.400 · 10005 · Không có kết hợp địa chỉ/số nào khả dụng.

Location

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