Trong trang này

Giới thiệu

Chào mừng bạn đến với tài liệu dành cho lập trình viên của QHTech. Tại đây bạn sẽ tìm thấy mọi thứ cần thiết để tích hợp QHTech vào hệ thống của mình: truy vấn giao dịch, sinh mã VietQR và nhận thông báo biến động số dư theo thời gian thực qua Webhook.

QHTech giúp bạn tự động hoá việc đối soát thanh toán chuyển khoản ngân hàng: mỗi khi có tiền vào/ra tài khoản, QHTech ghi nhận giao dịch và có thể đẩy ngay dữ liệu về máy chủ của bạn (Webhook) — phù hợp cho cổng thanh toán, nạp tiền tự động, xác nhận đơn hàng, v.v.

#Hai cách tích hợp

QHTech cung cấp hai hướng tích hợp, thường dùng kết hợp với nhau:

Hướng	Mô tả	Dùng khi
API	Bạn chủ động gọi tới QHTech để truy vấn dữ liệu (lịch sử giao dịch, danh sách ngân hàng) và sinh mã QR.	Kiểm tra, đối soát, hiển thị QR thanh toán.
Webhook	QHTech chủ động gửi dữ liệu giao dịch tới URL của bạn ngay khi phát sinh.	Xác nhận thanh toán tức thời, không cần hỏi lặp.

Khuyến nghị: Dùng Webhook để nhận thông báo tức thời và dùng API /transactions như phương án đối soát/dự phòng khi cần kiểm tra lại.

#Thông tin cơ bản

Base URL: https://app.qh2pay.com
Tiền tố API: mọi endpoint API nằm dưới đường dẫn /api, ví dụ https://app.qh2pay.com/api/transactions.
Định dạng dữ liệu: JSON
Charset: UTF-8
Đơn vị tiền tệ: VND (số nguyên, không có phần thập phân)
Xác thực: API Token dạng Authorization: Bearer {token} (xem trang Xác thực).

Nếu bạn chạy môi trường thử nghiệm cục bộ, hãy thay https://app.qh2pay.com bằng địa chỉ tương ứng (ví dụ http://localhost:8000).

#Bắt đầu nhanh

Tạo API Token trong dashboard tại menu Tích hợp → API Access. Xem hướng dẫn ở trang Xác thực.
Gọi thử API lịch sử giao dịch:

curl -G "https://app.qh2pay.com/api/transactions" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

Thiết lập Webhook để nhận giao dịch tức thời — xem Webhooks · Tổng quan.

#Cần hỗ trợ?

Nếu gặp vướng mắc khi tích hợp, hãy tạo Ticket hỗ trợ ngay trong dashboard QHTech. Đội ngũ kỹ thuật sẽ phản hồi trong thời gian sớm nhất.