Lấy Danh Sách Ngân Hàng

Đường dẫn

• URL: /cb-core/api/v1/disbursement/get-bank-list
• Method: POST
• Mô tả: API cho phép lấy danh sách các ngân hàng tại Việt Nam.

Request

Bảng Request

Tham số	Kiểu dữ liệu	Bắt buộc	Mô tả
request_id	string(50)	Có	Mã duy nhất tương ứng với yêu cầu. Định dạng: MerchantCode + BK + YYYYMMDD + UniqueId
request_time	string(19)	Có	Thời gian gửi yêu cầu từ merchant, định dạng: YYYY-MM-DD HH:MM:SS
merchant_code	string(20)	Có	Merchant code được cung cấp bởi Baokim trước khi tích hợp

Ví dụ Request

{
  "request_id": "MerchantCodeBK20231106UniqueId",
  "request_time": "2024-11-06 10:15:30",
  "merchant_code": "MerchantCode1234"
}

Response

Bảng Response

Tham số	Kiểu dữ liệu	Mô tả
response_code	int(4)	Mã lỗi từ Baokim theo Bảng Mã Lỗi
response_message	string(200)	Mô tả mã lỗi từ Baokim theo Bảng Mã Lỗi
data	array	Danh sách ngân hàng, mỗi ngân hàng chứa thông tin chi tiết như được chỉ định dưới đây

Cấu Trúc Mảng Data (Bên trong data)

Tham số	Kiểu dữ liệu	Mô tả
bank_no	string(20)	Mã định danh duy nhất cho ngân hàng
bank_name	string(100)	Tên đầy đủ của ngân hàng bằng tiếng Việt
eng_bank_name	string(100)	Tên đầy đủ của ngân hàng bằng tiếng Anh
bank_short_name	string(50)	Tên viết tắt hoặc tên gọi tắt của ngân hàng
supports_card_transfer	int(1)	Chỉ định ngân hàng có hỗ trợ chuyển khoản qua thẻ (true = 1, false = 0)
supports_account_transfer	int(1)	Chỉ định ngân hàng có hỗ trợ chuyển khoản qua tài khoản (true = 1, false = 0)

Ví dụ Response

{
  "response_code": 200,
  "response_message": "Success",
  "data": [
    {
      "bank_no": "970423",
      "bank_name": "Ngân hàng TMCP Tiên Phong",
      "eng_bank_name": "TIEN PHONG COMMERCIAL JOINT STOCK BANK",
      "bank_short_name": "TPBANK",
      "supports_card_transfer": 1,
      "supports_account_transfer": 1
    },
    {
      "bank_no": "970437",
      "bank_name": "Ngân hàng TMCP Phát Triển Thành Phố Hồ Chí Minh",
      "eng_bank_name": "Ho Chi Minh City Development Joint Stock Commercial Bank",
      "bank_short_name": "HDBANK",
      "supports_card_transfer": 0,
      "supports_account_transfer": 1
    },
    {
      "bank_no": "970422",
      "bank_name": "Ngân hàng TMCP Quân Đội",
      "eng_bank_name": "Military Commercial Joint Stock Bank",
      "bank_short_name": "MBBANK",
      "supports_card_transfer": 1,
      "supports_account_transfer": 0
    }
  ]
}

Mã Lỗi

Mã Response	Thông báo Response
200	Thành công
99	Đang xử lý
11	Thất bại
101	Lỗi Hệ thống
110	Merchant Code không hợp lệ
120	Signature không hợp lệ
422	Lỗi xác thực