HiTechCloud Pay API

HiTechCloud Pay API: bộ REST API truy vấn tài khoản ngân hàng doanh nghiệp, giao dịch, số dư và quản lý tài khoản ảo (Virtual Account) với phản hồi JSON chuẩn.

Xem Markdown

HiTechCloud Pay API là giao diện lập trình ứng dụng RESTful cho phép các hệ thống ERP, CRM, phần mềm kế toán và website thương mại điện tử kết nối trực tiếp với tài khoản ngân hàng. Với HiTechCloud Pay API, bạn có thể tự động hóa hoàn toàn quy trình kiểm tra số dư, trích xuất sao kê, theo dõi giao dịch và quản lý hệ thống tài khoản ảo.

Sơ đồ kết nối

Kiến trúc HiTechCloud Pay API
Hệ thống của bạnERP / CRM / Kế toán
Xác thựcAccess token (Bearer)
HiTechCloud Pay APIREST · JSON envelope
Tài khoản ngân hàngSố dư · giao dịch · VA
WebhookBiến động số dư real-time

Hệ thống của bạn gọi REST API bằng access token để truy vấn tài khoản, giao dịch và quản lý tài khoản ảo.

Các tính năng chính

  • Quản lý tài khoản ngân hàng: Lấy danh sách tài khoản liên kết, tên chủ tài khoản, ngân hàng, số dư hiện tại và trạng thái hoạt động.
  • Truy vấn lịch sử giao dịch: Lấy danh sách giao dịch thu/chi với bộ lọc đa chiều (theo thời gian, số tiền, từ khóa nội dung, số tài khoản).
  • Chi tiết giao dịch thời gian thực: Tra cứu chính xác từng bút toán qua định danh duy nhất UUID.
  • Quản lý tài khoản ảo (Virtual Account): Cấp phát và theo dõi tài khoản định danh riêng cho từng khách hàng hoặc đơn hàng (hỗ trợ Vietcombank, BIDV, Sacombank, Shinhan Bank, VPBank...).

Môi trường và Base URLs

Môi trườngBase URLMô tả
Production (Chính thức)https://userapi.hitechcloud.vnTruy vấn tài khoản và giao dịch thật
Sandbox (Thử nghiệm)https://userapi-sandbox.hitechcloud.vnMôi trường test với dữ liệu mô phỏng độc lập

Định dạng phản hồi Envelope

Tất cả phản hồi từ HiTechCloud Pay API đều tuân theo cấu trúc JSON Envelope chuẩn mực:

Cấu trúc phản hồi tiêu chuẩn
{
  "status": "success",
  "data": [],
  "meta": {
    "pagination": {
      "total": 100,
      "per_page": 20,
      "current_page": 1,
      "last_page": 5,
      "has_more": true
    }
  }
}

Danh mục tài liệu