# Tích hợp GMPay (khuyên dùng) 

Sử dụng GMPay cho tất cả các tích hợp mới.

## Đường dẫn 

```
POST /payments/gmpay/v1/order/create-transaction
```

## Yêu cầu về chứng nhận của thương nhân 

Trước khi gọi API, hãy tạo hoặc kiểm tra khóa API trong bảng quản trị.

Bạn cần:

* `pid`
* `secret_key`

Gửi `pid` trong yêu cầu và dùng `secret_key` làm khóa ký.

## Vận cần thiết tối thiểu 

```
{
  "pid": "1000",
  "order_id": "ORD20260424001",
  "currency": "cny",
  "token": "usdt",
  "network": "tron",
  "amount": 100,
  "notify_url": "https://merchant.example.com/notify",
  "signature": "hmac-sha256-hex(...)"
}
```

## Quy tắc ký tên 

> Kể từ phiên bản `v2.0.0`, GMPay sử dụng HMAC-SHA256 thay vì MD5\. Vui lòng nâng cấp các ứng dụng trước khi triển khai phiên bản v2, nếu không, họ sẽ nhận được thông báo `401 Unauthorized`. Các yêu cầu tương thích với EPay sẽ không bị ảnh hưởng.

1. Giữ lại tất cả các trường có giá trị, trừ `signature`
2. Sắp xếp tên trường theo thứ tự ASCII
3. Nối các cặp theo dạng `key=value&...`
4. Tính HMAC-SHA256 bằng `secret_key` của người bán làm khóa HMAC
5. Gửi chuỗi băm gồm 64 ký tự hex viết thường trong trường `signature`

## Các tuyến đường hỗ trợ 

* `GET /payments/gmpay/v1/config`
* `POST /pay/switch-network`

Nếu khách hàng cần các tùy chọn mạng/token linh hoạt, hãy đọc chúng từ `data.supported_assets` trong phản hồi `/payments/gmpay/v1/config`.

Xem `data.site` để thiết kế thương hiệu và `data.epay`, `data.okpay` và `data.xlayer` để cấu hình thanh toán.

## Xác minh callback 

Các thông báo từ GMPay được gửi dưới dạng JSON `POST` đến `notify_url`.

Xác minh chữ ký HMAC-SHA256, đối chiếu đơn hàng đã thanh toán và bảo đảm việc nhận lại cùng một thông báo không khiến đơn được xử lý nhiều lần. Trả về HTTP 200 cùng văn bản thuần `ok` hoặc `success` (không phân biệt chữ hoa, chữ thường).

## Ghi chú về thành công 

Nguồn hiện tại bao gồm `payment_url` trong các phản hồi tạo đơn hàng thành công, do đó, người gọi có một mục đích chuyển hướng thanh toán được quản lý trực tiếp, thay vì phải tự xây dựng lại URL đó.
