Tài liệu HDSD và tích hợp Tingee
  • I. Chung
    • 1.1. Lịch sử cập nhật
    • 1.2. Đăng ký tài khoản
    • 1.3. Tạo cửa hàng và liên kết tài khoản ngân hàng
      • 1.3.1. Liên kết ngân hàng tài khoản doanh nghiệp
    • 1.4. Tạo và tải QR Code ứng với tài khoản liên kết
    • 1.5. Thêm tài khoản nhân viên nhận thông báo
    • 1.6. Xem lịch sử giao dịch
  • II. Tích hợp trên các nền tảng thông báo biến động số dư
    • 2.1. Tích hợp Telegram
    • 2.2 Tích hợp Lark
    • 2.3. Tích hợp Zalo (Ngưng hỗ trợ)
  • III. WEB Tingee cho khách hàng Đại lý
    • 3.1. Hướng dẫn sử dụng WEB Tingee
  • IV. APP Tingee cho Nhân viên
    • 4.1. Hướng dẫn sử dụng APP Tingee
  • V. APP Tingee Merchant cho Chủ kinh doanh
    • 5.1. Tải APP và Đăng ký
    • 5.2. Tạo mới cơ sở/cửa hàng và thêm liên kết ngân hàng
    • 5.3. Thêm mới tài khoản nhân viên nhận thông báo
    • 5.4. Các màn hình khác
    • 5.5. HDSD Tingee Box
  • VI. Tích hợp phần mềm
    • 6.1. Tích hợp Webhook
    • 6.2. API Liên kết ngân hàng
      • 6.2.1. API Thêm mới liên kết (VA)
      • 6.2.2. API xác thực OTP
    • 6.3. API Tạo mã QR Code
    • 6.4. API Tạo mã QR Code động
    • 6.5. API lấy danh sách tài khoản định danh (VA)
    • 6.6. Tích hợp hiển thị QR Code trên thiết bị Tingee 3L
    • 6.7. Tích hợp Tingee Payment Gateway cho WooCommerce
Powered by GitBook
On this page
  1. VI. Tích hợp phần mềm

6.5. API lấy danh sách tài khoản định danh (VA)

Api lấy danh sách tài khoản định danh (VA)

Previous6.4. API Tạo mã QR Code độngNext6.6. Tích hợp hiển thị QR Code trên thiết bị Tingee 3L

Last updated 9 months ago

API lấy danh sách VA

POST - Môi trường live

POST - Môi trường test

Gửi lệnh lấy danh sách VA

Headers

Name
Type
Description

x-client-id

string

x-request-timestamp

string

Dấu thời gian (yyyyMMddHHmmssSSS)

x-signature

string

Quy tắc kiểm tra tính toàn vẹn dữ liệu: Chuỗi giá trị cần hash = {x-request-timestamp}:{request body convert về string}

Sau đó thực hiện mã hóa chuỗi bên trên với giải thuật: HMAC SHA512 với Key là Secret token lấy tại mục Developers trên Tingee

Request Body

Name
Type
Description

filter

string

Từ khóa tìm kiếm

skipCount*

number

Số bản ghi bỏ qua

maxResultCount*

number

Số bản ghi của 1 trang

bankName

enum

Ngân hàng (OCB, BIDV, MBB, ACB và VPB), giá trị null sẽ lấy tất cả

{
  "totalCount": 0, // Tổng bản ghi
  "items": [ //danh sách bản ghi của 1 trang
    {
      "bankName": "OCB",//Ngân hàng
      "bankBin": "970448",//Mã bin ngân hàng
      "accountType": "personal-account",//loại tài khoản
      "accountName": "string",//Chủ tài khoản
      "accountNumber": "string",//Số tài khoản
      "vaAccountNumber": "string",//Số tài khoản định danh
      "status": "inactive", //trạng thái
      "creationTime": "2024-07-18T02:46:05.724Z", //ngày tạo
    }
  ]
}
{
  "message": "Unauthorized.",
  "error": "Unauthorized",
  "statusCode": 401
}
{
  "message": "Not have access.",
  "error": "Bad Request",
  "statusCode": 400
}
{
  "message": "Forbidden.",
  "error": "Forbidden",
  "statusCode": 403
}
{
  "message": "Not Found.",
  "error": "Not Found",
  "statusCode": 404
}
{
  "message": "Internal Server Error.",
  "error": "Internal Server Error",
  "statusCode": 500
}
{
  "message": "Not Implemented.",
  "error": "Not Implemented",
  "statusCode": 501
}

Ví dụ CURL:

curl --location 'https://open-api.tingee.vn/v1/get-va-paging' \
--header 'accept: application/json' \
--header 'Content-Type: application/json' \
--header 'x-request-timestamp: 20240524155831608' \
--header 'x-client-id: f4ba500b1f5798399907cd7ba41d368c' \
--header 'x-signature: e8547f7a75659319487894454e2eef005f20d7bcb391713f46ca6a574c5585d6a663e01afd6feb7a56291e5a95b93cadbc5f89413729110f7868c58788c4a219' \
--data '{
  "filter": "",
  "skipCount": 0,
  "maxResultCount": 0,
  "bankName": "OCB",
}'

Định danh ứng dụng (Lấy trong )

https://open-api.tingee.vn/v1/get-va-paging
https://uat-open-api.tingee.vn/v1/get-va-paging
https://app.tingee.vn/m/developers
Page cover image