Virtual Account

Tạo Tài khoản định danh (Tài khoản ảo).

Tài liệu về API

Chi tiết Virtual Account yêu cầu, phản hồi và code mẫu

Xem chi tiết Virtual Account API

Bắt đầu

Tìm hiểu về các thông tin để triển khai và cách thức hoạt động.

Bắt đầu

Tài khoản định danh (Tài khoản ảo) là tài khoản phụ liên kết trực tiếp với tài khoản chính của khách hàng. Số Tài khoản định danh được thiết kế và hiển thị dưới dạng dãy chữ/số ký tự tuân theo cấu trúc VA do bankHub cung cấp.

Tài khoản định danh có chức năng là số tài khoản thụ hưởng của khách hàng, giúp quản lý khoản phải thu dễ dàng, giảm thiểu số lượng tài khoản chuyên thu tại các ngân hàng, chủ động trong việc tạo và quản lý các số Tài khoản định danh thuận tiện cho người dùng.

Các bước tích hợp Virtual Account

Dưới đây là các bước để tích hợp Virtual Account vào sản phẩm của bạn.

1. Tạo một phân quyền /grant/token với scopes là virtual_account, virtualAccountNumber có giá trị được thiết lập theo cấu trúc phía bankHub cung cấp cho bạn và fiServiceId mã dịch vụ tài chính đăng ký VA này.

• virtualAccountNumber: sẽ được cấu hình riêng cho mỗi ứng dụng và mỗi dịch vụ tài chính tương ứng.
• fiServiceId: bạn có thể gọi API /fi-services để lấy thông tin.

2. Mở giao diện bankHub Link bằng grantToken được trả về ở bước trên. Xem chi tiết

3. Sau khi người dùng hoàn tất xác thực, phía giao diện của bạn sẽ nhận được một publicToken, dùng publicToken này để lấy accessToken cho phân quyền.

4. Sau khi có accessToken, gọi API Lấy thông tin Tài khoản định danh để kiểm tra thông tin chi tiết của TK và bắt đầu thêm vào hệ thống của bạn.

5. Kiểm tra VA hợp lệ với hệ thống của bạn, với trường hợp không hợp lệ gọi API /grant/remove để thực hiện xoá phân quyền.

Gọi API

Tạo phân quyền cho Virtual Account

CURL

curl --location 'https://sandbox.bankhub.dev/grant/token' \
--header 'X-BankHub-Api-Version: 2023-01-01' \
--header 'x-client-id: <CLIENT_ID_HERE>' \
--header 'x-secret-key: <SECRET_KEY_HERE>' \
--header 'Content-Type: application/json' \
--data '{
    "scopes": "virtual_account",
    "language": "vi",
    "redirectUri": "https://your-domain.vn/link",
    "fiServiceId": "ebf7fe6d-af63-11ee-aa7e-42010a400022",
    "virtualAccountNumber": "V3CASLWXF4RGGY6"
}'

Javascript (Axios)

 const axios = require('axios');
 const data = JSON.stringify({
   "scopes": "virtual_account",
   "language": "vi",
   "redirectUri": "https://your-domain.vn/link",
   "fiServiceId": "ebf7fe6d-af63-11ee-aa7e-42010a400022",
   "virtualAccountNumber": "V3CASLWXF4RGGY6"
 });

 const config = {
   method: 'post',
   maxBodyLength: Infinity,
   url: 'https://sandbox.bankhub.dev/grant/token',
   headers: { 
     'X-BankHub-Api-Version': '2023-01-01', 
     'x-client-id': '<CLIENT_ID_HERE>', 
     'x-secret-key': '<SECRET_KEY_HERE>', 
     'Content-Type': 'application/json'
   },
   data: data
 };

 axios.request(config)
 .then((response) => {
   console.log(JSON.stringify(response.data));
 })
 .catch((error) => {
   console.log(error);
 });

thông tin

Xem chi tiết API, tại đây

Lấy accessToken từ publicToken

CURL

  curl --location 'https://sandbox.bankhub.dev/grant/exchange' \
  --header 'X-BankHub-Api-Version: 2023-01-01' \
  --header 'x-client-id: <CLIENT_ID_HERE>' \
  --header 'x-secret-key: <SECRET_KEY_HERE>' \
  --header 'Content-Type: application/json' \
  --data '{
      "publicToken": "bdbde2bad-7685-4f95-987c-71309a4a3"
  }'

Javascript (Axios)

  const axios = require('axios');
  const data = JSON.stringify({
    "publicToken": "bdbde2bad-7685-4f95-987c-71309a4a3"
  });

  let config = {
    method: 'post',
    maxBodyLength: Infinity,
    url: 'https://sandbox.bankhub.dev/grant/exchange',
    headers: { 
      'X-BankHub-Api-Version': '2023-01-01', 
      'x-client-id': '<CLIENT_ID_HERE>', 
      'x-secret-key': '<SECRET_KEY_HERE>', 
      'Content-Type': 'application/json'
    },
    data: data
  };

  axios.request(config)
    .then((response) => {
      console.log(JSON.stringify(response.data));
    })
    .catch((error) => {
      console.log(error);
    });

thông tin

Xem chi tiết API, tại đây

Lấy thông tin Tài khoản định danh

CURL

  curl --location 'https://sandbox.bankhub.dev/virtual-account/identity' \
  --header 'X-BankHub-Api-Version: 2023-01-01' \
  --header 'Authorization: <ACCESS_TOKEN_HERE>' \
  --header 'x-client-id: <CLIENT_ID_HERE>' \
  --header 'x-secret-key: <SECRET_KEY_HERE>'

Javascript (Axios)

  const axios = require('axios');

  let config = {
    method: 'get',
    maxBodyLength: Infinity,
    url: 'https://sandbox.bankhub.dev/virtual-account/identity',
    headers: { 
      'X-BankHub-Api-Version': '2023-01-01', 
      'Authorization': '<ACCESS_TOKEN_HERE>', 
      'x-client-id': '<CLIENT_ID_HERE>', 
      'x-secret-key': '<SECRET_KEY_HERE>'
    }
  };

  axios.request(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });

thông tin

Xem chi tiết API, tại đây