4. Tạo tài khoản ảo

- API path: /api/payment/v1/virtualAccount/enable

- Method: POST

- Mô tả: API do KLB Pay cung cấp dùng để tạo mới một tài khoản ảo theo order với cấu trúc tài khoản ảo do Kienlongbank Pay quy định như sau: |Mã dịch vụ|99|Mã đối tác|5 số order|checksum|

Tham số trong Request Body

Key	Type	Require	Value
data	String	✓	Chứa dữ liệu đã được mã hóa

Các thông tin trường data lúc chưa mã hóa:

Key	Type	Require	Ý nghĩa
order	Number	✓	Order của tài khoản ảo (0-99999)
timeout	Number		Thời gian (giây) hết hạn của tài khoản ảo (truyền 0 nếu vô thời hạn)
fixAmount	Number		Số tiền giao dịch cố định gán với tài khoản ảo, truyền 0 nếu không ràng buộc.
fixContent	String		Nội dung mặc định của VietQR
bankAccountNo	String		Số tài khoản ngân hàng gán với tài khoản ảo (truyền NULL nếu chọn tài khoản mặc định của merchant)

Tham số trong Response Body

Key	Type	Value
code	Number	Mã lỗi
message	String	Mô tả thông tin mã lỗi
data	String	Chứa dữ liệu đã được mã hóa

Các thông tin trường data lúc chưa mã hóa:

Key	Type	Value
order	Number	Order của tài khoản ảo
virtualAccount	String	Tài khoản ảo
bankAccountNo	String	Số tài khoản ngân hàng gán với tài khoản ảo
fixAmount	Number	Số tiền giao dịch gán với tài khoản ảo
fixContent	String	Nội dung giao dịch gán với tài khoản ảo
qrContent	String	QRcode dưới dạng string
timeout	Number	Thời gian hết hạn của tài khoản ảo

Ví dụ

• Request Mẫu
  • Request Body

      {
          "data": "o1n1sRVQUIlavzARhLBHFiBKT7ThPKJpqXu6SRD/D4gIAHpKHDh2xGUwsB21Nh6nOOyCN9LWYZ3gZBzY2Nr3kQr9gFg9rBctfjA9pQuxpyw="
      }
  • Giá trị trường data trước khi encrypt:

      {
        "bankAccountNo": "",
        "fixAmount": 500000,
        "fixContent": "Mo ta",
        "order": 8888,
        "timeout": 1000000
      }
• Response mẫu
  • Response Data:

      {
        "code": 0,
        "data": "QDM2w97TrnQzaMyz5hQGzm+VgRmtd5xKkfWfAaPB5NXSG7vfwx89QiuS74N+d7JRYLVOuAhIXa3wz+wlllcPRfbojlhw/WRP76lzJ2rl0HRb6wZdcRggUAbM4j0GwBPnBccQQ0t+LQsKz13+6IwYcmKUw2wZe+5CDr0G3U0GshEw5rCGRT9v/KRIc1oJ5FkaFNuIucVD+6Gd/ZjNMirUKXOfw3I4r1YAiNRH/8SQcicHNk+MZlWhahxKevXfV7Xt5pEioRjvmrB+1gHOWWN1H+PGeimbpkzi0qeM8nyxXv/8N7NMkqt0xLR79c5cuoMYY2OAYt9Fm9Q+O1/zKKWJ2LdB4pO7gouk45+xygGmK1KPh0fKzhuOa+u7APnQtYmC",
        "message": "Success"
      }
  • Gía trị trường data trước khi encrypt:

      {
        "bankAccountNo": "4570834602",
        "fixAmount": 500000,
        "fixContent": "Mo ta",
        "order": 8888,
        "qrContent": "00020101021238620010A0000007270132000697045201181093992827920888840208QRIBFTTA530370454065000005802VN62090805Mo ta63048959",
        "timeout": 1000000,
        "virtualAccount": "109399282792088884"
      }