Tài liệu API
Xem API của Thương nhân để tham khảo các ví dụ, trạng thái đơn hàng và xác minh thông báo.
Các tuyến đường công cộng trực tiếp
| Mục đích | Phương thức | Đường dẫn | Xác thực |
|---|---|---|---|
| Tạo đơn GMPay | POST | /payments/gmpay/v1/order/create-transaction | HMAC-SHA256 của người bán |
| Đọc cấu hình thanh toán | GET | /payments/gmpay/v1/config | Công khai |
| Mở trang thanh toán | GET | /pay/checkout-counter/{trade_id} | Công khai |
| Đọc chi tiết thanh toán | GET | /pay/checkout-counter-resp/{trade_id} | Công khai |
| Kiểm tra trạng thái đơn | GET | /pay/check-status/{trade_id} | Công khai |
| Chọn mạng hoặc nhà cung cấp | POST | /pay/switch-network | Công khai |
| Gửi mã băm giao dịch | POST | /pay/submit-tx-hash/{trade_id} | Công khai |
| Quay về trang người bán | GET | /pay/return/{trade_id} | Chuyển hướng trình duyệt |
| Tạo đơn EPay | GET hoặc POST | /payments/epay/v1/order/create-transaction/submit.php | MD5 của người bán |
| Nhận thông báo OKPay | POST | /payments/okpay/v1/notify | Chữ ký OKPay |
Giao diện API quản trị
Các API quản lý nằm ở /admin/api/v1/* và được bảo vệ bằng JWT, ngoại trừ các điểm cuối (endpoints) đăng nhập và thiết lập mật khẩu ban đầu.
Các nhóm chính được hiển thị trong nguồn hiện tại:
- Nhân viên thu ngân công cộng chấp nhận một hash cho đơn hàng đang chờ xử lý trên chuỗi. Đồng thời, một quản trị viên cũng có thể kiểm tra lại các đơn hàng hết hạn hoặc các đơn hàng đang được xem xét thủ công.
- Cài đặt tỷ giá:
rate.modecó thể là fixed hoặc auto. Chế độfixedsử dụngrate.forced_rate_list, trong khi chế độautosẽ lấyrate.api_url, lưu trữ các phản hồi tỷ giá cơ bản thành công, và duy trì bộ nhớ cache bền vững cuối cùng khi cập nhật thất bại. Nếurate.forced_rate_listtrống, hệ thống sẽ khôi phục tỷ giá mặc định CNY USDT/USDC mặc định. /auth/*/api-keys/*/notification-channels/*/config- quản lý chuỗi / quản lý token chuỗi
- quản lý địa chỉ ví
- quản lý cài đặt
Quy định về chứng nhận thương nhân
GMPay
- Mã người bán bắt buộc:
pid - Trường chữ ký:
signature - Thuật toán chữ ký từ phiên bản
v2.0.0: HMAC-SHA256 dựa trên chuỗi tham số không trống và chuẩn, được mã hóa bằng khóaapi_keys.secret_keyphù hợp vớipid. - Khách hàng GMPay MD5 trước phiên bản v2 phải được nâng cấp trước khi triển khai phiên bản
v2.0.0trở lên.
Luồng thanh toán tương thích với EPay
- Mã người bán bắt buộc:
pid - Trường chữ ký:
sign - Khóa ký:
secret_keycủa dòngapi_keysđược kích hoạt, phù hợp vớipid. sign_typeđược chấp nhận, thường làMD5.- EPay
typechấp nhậnalipayhoặc một trình chọn (selector) được hỗ trợ từtoken.networknhưusdt.tron. Các trình chọn được chấp nhận sẽ được lưu giữ trong các callback trả về/thông báo của EPay.
Thứ tự tích hợp được đề xuất
- Tạo hoặc kiểm tra thông tin xác thực của người bán trong bảng điều khiển (
pid+secret_key) - Truy vấn
/payments/gmpay/v1/configvà đọcdata.supported_assetsnếu khách hàng cần các tùy chọn mạng/token động - Ưu tiên sử dụng GMPay cho các tích hợp mới.
- Chỉ sử dụng chuyển hướng tương thích với EPay khi hệ thống trước đó yêu cầu luồng này.
- Xác minh callback bằng chính
secret_keycủa người bán