🚀 TTJB Payment API Docs

Tài liệu tích hợp Gateway thanh toán tự động qua SePay

POST /api/payment/qr Tạo mã QR & Khởi tạo đơn hàng

Request Body (JSON)

{ "order_id": "VIP_12345", "amount": 50000, "project": "TTJBProject" }

Responses

200 OK
{ "success": true, "data": { "order_id": "VIP_12345", "qr_url": "https://qr.sepay.vn/img?...", "timeout": 900 } }
GET /api/payment/status/:order_id Polling check trạng thái đơn

Parameters

order_id (Path): Mã đơn hàng cần kiểm tra. Ví dụ: VIP_12345

Responses

200 OK
{ "success": true, "data": { "order_id": "VIP_12345", "status": "SUCCESS", "amount": 50000 } }
GET /api/payment/history Lấy danh sách đơn thành công

Authentication

Yêu cầu quyền Admin. Truyền Key qua Header.

Header x-admin-key: YOUR_ADMIN_KEY

Responses

200 OK
{ "success": true, "count": 1, "data": [ { "order_id": "VIP_12345", "project": "TTJBProject", "amount": 50000, "status": "SUCCESS" } ] }
403 Forbidden
{ "success": false, "message": "Quyền truy cập bị từ chối! Vui lòng kiểm tra lại Header x-admin-key." }