TConnect Payment Open API
👋 Chào mừng bạn đến với TConnect Payment Open API - giải pháp thanh toán tự động hóa toàn diện cho mọi hệ thống từ ERP, PMS, HIS, ứng dụng AI đến Kiosk và thiết bị POS. Hãy khám phá tài liệu này để tìm mô hình thanh toán phù hợp nhất cho dự án của bạn!
Tài liệu tích hợp hệ thống thanh toán OPEN API của TConnect.
API này giúp bạn làm gì?
| Tính năng | Mô tả |
|---|---|
| 🔐 Xác thực JWT | Đăng nhập và quản lý phiên bảo mật với Access Token + Refresh Token |
| 🔳 Tạo mã QR | Khởi tạo QR tĩnh hoặc QR động chứa số tiền đơn hàng |
| 🔔 IPN Callback | Nhận thông báo thanh toán thành công tức thời |
| 📟 Push to Devices | Đẩy thông tin thanh toán xuống máy POS hoặc loa Soundbox |
| 📊 Lịch sử giao dịch | Tra cứu giao dịch QR, thẻ, tiền mặt có phân trang |
| ⚙️ Danh sách dịch vụ | Kiểm tra các cổng thanh toán đang được cấp phép |
Xác thực (Authentication)
Sử dụng JWT Bearer token. Gọi POST /openapi/v1/auth/login để lấy access_token,
sau đó thêm vào header Authorization: Bearer <token> cho mọi request tiếp theo.
HTTP: Bearer Auth
| Thuộc tính | Giá trị |
|---|---|
| Security Scheme Type | http |
| HTTP Authorization Scheme | bearer |
| Bearer format | JWT |
JWT access_token lấy từ API Login.
API Key: partnerCode
| Thuộc tính | Giá trị |
|---|---|
| Security Scheme Type | apiKey |
| Header parameter name | Partner-Code |
Mã định danh Merchant (TCONNECT cung cấp).
Mã hóa (Encryption)
Toàn bộ Request Body (trừ API Get Services) được mã hóa AES-256-CBC.
Trường data chứa payload đã mã hóa dưới dạng Hexadecimal.
Toàn bộ Request Body đều phải được mã hóa AES-256-CBC.
Xem chi tiết tại AES Encryption.
Thông tin môi trường
| Môi trường | Base URL |
|---|---|
| Staging | https://sme-open-api-sandbox.tconnect.vn |
| Production | Được cung cấp sau khi hoàn tất kiểm thử |
1. Luồng thanh toán bằng QR
2. Luồng thanh toán bằng QR trên thiết bị (POS, Soundbox)
Bước tiếp theo
- 👉 API Login — Bắt đầu từ bước xác thực
- 👉 Get Services — Lấy danh sách dịch vụ thanh toán
- 👉 AES Encryption — Chi tiết mã hóa request
Liên hệ
TConnect
Email: info@tconnect.vn
URL: https://tconnect.vn