Skip to main content

🚀 API v1.0.0 – Phát hành phiên bản đầu tiên

Phiên bản v1.0.0 là bản phát hành chính thức đầu tiên của Tingee API, bao gồm toàn bộ hệ thống Banking & VA, QR Code, TingeeBox, Deep Link, Webhook và SDK.

Đây là nền tảng chuẩn để các đối tác tích hợp đầy đủ dịch vụ thanh toán & thiết bị của Tingee.

📦 SDK​

Thư viện SDK chính thức hỗ trợ tích hợp nhanh các Open API của Tingee:

  • NodeJS — npm package, hỗ trợ TypeScript
  • .NET — NuGet package, tương thích .NET 6+
  • Java — Maven/Gradle, hỗ trợ Spring Boot
  • PHP — Composer package, tương thích PHP 7.4+

🏦 Banking & VA​

Bao gồm trọn bộ API liên kết tài khoản và xử lý giao dịch:

  • Danh sách ngân hàng hỗ trợ
  • Danh sách số tài khoản
  • Tạo / Liên kết số tài khoản
  • Xác nhận số tài khoản
  • Đăng ký nhận biến động số dư
  • Xác nhận đăng ký biến động
  • Xóa số tài khoản
  • Xác nhận xóa
  • Hoàn tiền giao dịch
  • Lịch sử giao dịch

📱 QR Code​

Hỗ trợ cả QR tĩnh và động:

QR Code tĩnh:

  • Tạo QR VietQR tĩnh chuẩn NAPAS

QR Code động:

  • Tạo QR động theo từng đơn hàng cụ thể
  • Xóa QR động
  • Kiểm tra trạng thái thanh toán QR động

📦 TingeeBox​

Tích hợp thiết bị thanh toán TingeeBox tại điểm bán:

  • Đọc mã bảo mật thiết bị
  • Đọc số tiền giao dịch
  • Hiển thị QR Code trên màn hình thiết bị
  • Tạo và hiển thị QR động trực tiếp trên thiết bị
  • Thêm thiết bị vào cửa hàng
  • Cập nhật trạng thái liên kết thiết bị
  • Danh sách thiết bị theo Merchant
  • Danh sách thiết bị theo cửa hàng / tài khoản VA

🔗 Pay by Bank (Deep Link)​

Tích hợp thanh toán qua app ngân hàng bằng Deep Link:

  • Tạo Deep Link thanh toán, mở thẳng app ngân hàng
  • Nhận kết quả thanh toán qua callback URL từ đối tác

🌐 Webhook (IPN)​

Nhận thông báo giao dịch theo thời gian thực:

  • Webhook thanh toán QR và Deep Link
  • Webhook biến động số dư tài khoản VA
  • Xác thực chữ ký Webhook đảm bảo bảo mật

⚙️ Vận hành & Mở rộng​

Quản lý hệ thống đa tầng cho Master Merchant:

  • Quản lý Merchant con (tạo, tra cứu)
  • Quản lý Cửa hàng (tạo, cập nhật, tra cứu)
  • Quản lý Thiết bị (reset thiết bị)
  • Cấu hình tài khoản doanh nghiệp (tạo, cập nhật, xóa)

🔐 Bảo mật​

  • Xác thực API Key bắt buộc cho mọi request
  • Kiểm tra chữ ký HMAC cho Webhook IPN
  • Bắt buộc HTTPS toàn bộ endpoint
  • Rate limit và giới hạn kích thước request mặc định