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-transactionYê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:
pidsecret_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áo401 Unauthorized. Các yêu cầu tương thích với EPay sẽ không bị ảnh hưởng.
- Giữ lại tất cả các trường có giá trị, trừ
signature - Sắp xếp tên trường theo thứ tự ASCII
- Nối các cặp theo dạng
key=value&... - Tính HMAC-SHA256 bằng
secret_keycủa người bán làm khóa HMAC - 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/configPOST /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 đó.