Tạo VA

Quy trình

MERCHANT gọi API để tạo ra VA tĩnh hoặc VA động theo từng giao dịch.

Thông tin API

• URL: /b2b/core/api/ext/mm/bank-transfer/create
• Method: POST

Request

(Tham số Đối tác gửi lên)

Bảng tham số chính

Tham số Đối tác gửi lên

STT	Tên trường	Kiểu dữ liệu	Bắt buộc	Mô tả
1	request_id	String(100)	✅	Id duy nhất ứng với mỗi Request từ MERCHANT sang Baokim
2	request_time	String(20)	✅	Thời gian gửi Request. Format: YYYY-MM-DD H:i:s
3	master_merchant_code	String(50)	✅	Mã định danh duy nhất cho MASTER MERCHANT
4	sub_merchant_code	String(50)	✅	Mã định danh duy nhất cho SUB MERCHANT
5	acc_name	String	✅	Tên tài khoản VA
6	acc_type	Integer	✅	Loại VA: 1 = Động, 2 = Tĩnh
7	store_code	String	❌	Mã cửa hàng
8	branch_code	String	❌	Mã chi nhánh
9	staff_code	String	❌	Mã nhân viên
10	mrc_order_id	String	✅	Mã đơn hàng Merchant
11	bank_code	String	❌	Ngân hàng muốn tạo VA (default: NULL)
12	collect_amount_min	Integer	❌	Số tiền tối thiểu (2.000đ). acc_type = 1: min = max; acc_type = 2: NULL
13	collect_amount_max	Integer	✅	Số tiền tối đa
14	expire_date	String	❌	Ngày hết hạn VA. acc_type = 1: default NULL; acc_type = 2: bắt buộc
15	memo	String	❌	Nội dung chuyển khoản

Ví dụ request

{
  "request_id": "MERCHANT050015588AXE00",
  "request_time": "2020-08-11 14:41:00",
  "master_merchant_code": "MASTERMERCHANT",
  "sub_merchant_code": "SUBMERCHANT",
  "acc_name": "NGUYEN VAN A",
  "acc_type": 1,
  "store_code": null,
  "branch_code": null,
  "staff_code": null,
  "mrc_order_id": "ORD_123456789",
  "bank_code": null,
  "collect_amount_min": 20000,
  "collect_amount_max": 20000,
  "expire_date": null,
  "memo": "Thanh toan don hang"
}

Response

(Tham số Baokim trả cho Đối tác)

Bảng tham số chính

STT	Tên trường	Kiểu dữ liệu	Bắt buộc	Mô tả
1	code	Number(3)	✅	Mã lỗi của Baokim
2	message	String(200)	✅	Thông báo mã lỗi của Baokim
3	data	Object	✅	Dữ liệu Baokim trả về

Thông tin data

STT	Tên trường	Kiểu dữ liệu	Bắt buộc	Mô tả
1	order_id	Integer	✅	Mã đơn hàng của Baokim
2	mrc_order_id	String	✅	Mã đơn hàng Merchant
3	acc_type	Integer	✅	Loại VA: 1 = Động, 2 = Tĩnh
4	collect_amount_min	Integer	❌	Số tiền tối thiểu (2.000đ); acc_type = 1 thì min = max; acc_type = 2 thì NULL
5	collect_amount_max	Integer	✅	Số tiền tối đa
6	expire_date	String	❌	Ngày hết hạn VA: acc_type = 1, default = NULL / acc_type = 2: required
7	bank_name	String	✅	Tên ngân hàng VA
8	bank_branch	String	❌	Chi nhánh
9	acc_no	String	✅	Số tài khoản VA
10	acc_name	String	✅	Tên tài khoản VA
11	qr_string	Text	✅	Chuỗi QR
12	qr_path	String	✅	Đường dẫn ảnh QR

Ví dụ response

{
  "code": 0,
  "message": "Success",
  "data": {
    "order_id": 1870436,
    "mrc_order_id": "ORD_123456789",
    "acc_type": 1,
    "collect_amount_min": 20000,
    "collect_amount_max": 20000,
    "expire_date": null,
    "bank_name": "Ngân hàng TMCP Ngoại Thương Việt Nam (Vietcombank)",
    "bank_branch": "Chi nhánh Hà Nội",
    "acc_no": "01234567890123",
    "acc_name": "BAOKIM NGUYEN VAN A",
    "qr_string": "00020101021238550010A0000007270123000697040300000000000020386304C3A4",
    "qr_path": "https://sandbox.baokim.vn/qr/BK1234567890.png"
  }
}

Error Codes

Mã lỗi	Mô tả
100	Thành công
11	Thất bại
101	Lỗi hệ thống Baokim
103	Lỗi xác thực chữ ký
104	Lỗi xác thực JWT
422	Dữ liệu không hợp lệ
710	Sub merchant không tồn tại
711	Master merchant không tồn tại
712	Sub merchant đang không hoạt động
713	Master merchant đang không hoạt động