# Tạo đơn GMPay 

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

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

Ký yêu cầu trên máy chủ rồi mở `payment_url` cho người mua. Gửi cả `token` và `network` hoặc bỏ cả hai để người mua tự chọn.

## Tham số 

| Trường        | Kiểu  | Bắt buộc     | Mô tả                                                                                                                                                                         |
| ------------- | ----- | ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| pid           | Chuỗi | Có           | Trước đây, Merchant PID đã sử dụng để tìm kiếm khóa ký.                                                                                                                       |
| order\_id     | Chuỗi | Có           | Mã đơn hàng độc đáo của nhà bán hàng, tối đa 32 ký tự.                                                                                                                        |
| currency      | Chuỗi | Có           | Loại tiền pháp định, chẳng hạn usd hoặc cny.                                                                                                                                  |
| token         | Chuỗi | Có điều kiện | Tiếp nhận tài sản. Kết hợp với mạng hoặc bỏ cả hai.                                                                                                                           |
| network       | Chuỗi | Có điều kiện | ID mạng từ cấu hình công khai, ví dụ: binance.                                                                                                                                |
| amount        | Số    | Có           | Số fiat lớn hơn 0,01.                                                                                                                                                         |
| notify\_url   | Chuỗi | Có           | URL hồi báo thành công không đồng bộ.                                                                                                                                         |
| redirect\_url | Chuỗi | Không        | Trang web được trả về bởi trình duyệt.                                                                                                                                        |
| name          | Chuỗi | Không        | Tên sản phẩm hoặc đơn hàng.                                                                                                                                                   |
| payment\_type | Chuỗi | Không        | Mặc định sử dụng GMPay. EPay (không phân biệt chữ hoa/chữ thường) chọn định dạng callback của EPay và yêu cầu một PID số. Bao gồm bất kỳ giá trị nào không rỗng trong chữ ký. |
| signature     | Chuỗi | Có           | Chữ ký HMAC-SHA256 với độ dài 64 ký tự (thường là chữ).                                                                                                                       |

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 

* [Mở trang thanh toán](https://epusdt.com/vi/api/endpoints/open-checkout)
* [Quy tắc ký](https://epusdt.com/vi/api/payment#signing)

## Phản hồi

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` object  
Dữ liệu trả về; null khi có lỗi.

  * `trade_id` string
  * `order_id` string
  * `status` integer
  * `expiration_time` integer
  * `payment_url` string
* `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ý.

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**

URL cổng thanh toán 

```
curl -i -X POST \
  'https://pay.example.com/payments/gmpay/v1/order/create-transaction' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "pid": "1000",
  "order_id": "ORD202605230001",
  "currency": "cny",
  "token": "usdt",
  "network": "tron",
  "amount": 100,
  "notify_url": "https://merchant.example/notify",
  "redirect_url": "https://merchant.example/return",
  "name": "VIP",
  "signature": "6f874b1919d95081835e2809b620e354a5866f5a6dbb2e432d1627f1eb10059d"
}'
```

**Ví dụ phản hồi**200 · Thành cô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.

application/json · Một số trường phản hồi

```
{
  "status_code": 200,
  "message": "success",
  "data": {
    "trade_id": "20260523171652123456001",
    "order_id": "ORD202605230001",
    "status": 1,
    "expiration_time": 1779530812,
    "payment_url": "https://pay.example.com/pay/checkout-counter/20260523171652123456001"
  },
  "request_id": "b1344d70-ff19-4543-b601-37abfb3b3686"
}
```
