Danh sách ngân hàng

Quy trình

Mô tả: Merchant gọi API này để lấy danh sách Ngân hàng Bảo Kim hỗ trợ (chỉ trả về các ngân hàng đang hoạt động), phục vụ cho việc hiển thị danh sách ngân hàng để khách hàng lựa chọn khi thực hiện các giao dịch liên quan đến ngân hàng (ví dụ: liên kết tài khoản, chuyển khoản...).

Thông tin API

Method: GET

URL: /api/ext/banks

Request

API này không yêu cầu truyền tham số (không có query string, không có body) và không yêu cầu xác thực (không cần header Authorization/chữ ký merchant).

Lưu ý: Endpoint chịu giới hạn tần suất gọi (rate limit) mặc định của hệ thống là 600 requests/phút.

Bảng tham số chính: Không có tham số truyền vào

Ví dụ request

curl --location --request GET 'https://{domain}/api/ext/banks'

Response

Dữ liệu trả về là danh sách các ngân hàng đang hoạt động (đã được lọc theo trạng thái kích hoạt), được bọc trong envelope chuẩn code / message / data.

Bảng tham số chính

Tham số	Kiểu dữ liệu	Mô tả
code	int	Mã kết quả trả về. 0: thành công
message	string, null	Thông báo kèm theo (thường là null khi thành công)
data	object	Đối tượng chứa dữ liệu trả về
data.list_banks	array	Danh sách các ngân hàng đang hoạt động

Thông tin ngân hàng (banks)

Tham số	Kiểu dữ liệu	Mô tả
bank_no	string	Mã ngân hàng
name	string	Tên đầy đủ của ngân hàng
short_name	string	Tên viết tắt của ngân hàng
logo_link	string	Đường dẫn (URL) tới logo của ngân hàng

Ví dụ response

{
    "code": 0,
    "message": null,
    "data": {
        "list_banks": [
            {
                "bank_no": "970423",
                "name": "Ngân hàng TMCP Tiên Phong",
                "short_name": "TPBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/TPBANK.png"
            },
            {
                "bank_no": "970437",
                "name": "Ngân hàng TMCP Phát Triển Thành Phố Hồ Chí Minh",
                "short_name": "HDBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/HDBANK.png"
            },
            {
                "bank_no": "970408",
                "name": "Ngân hàng TM TNHH MTV Dầu Khí Toàn Cầu",
                "short_name": "GPBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/GPBANK.png"
            },
            {
                "bank_no": "970407",
                "name": "Ngân hàng TMCP Kỹ thương Việt Nam",
                "short_name": "TECHCOMBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/TECHCOMBANK.png"
            },
            {
                "bank_no": "970442",
                "name": "Ngân hàng TNHH MTV Hongleong Việt Nam",
                "short_name": "HONGLEONGBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/HONGLEONGBANK.png"
            },
            {
                "bank_no": "970414",
                "name": "Ngân hàng TMCP Đại Dương",
                "short_name": "OCEANBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/OCEANBANK.png"
            },
            {
                "bank_no": "970438",
                "name": "Ngân hàng TMCP Bảo Việt",
                "short_name": "BAOVIET",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/BAOVIETBANK.png"
            },
            {
                "bank_no": "970422",
                "name": "Ngân hàng TMCP Quân Đội",
                "short_name": "MBBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/MB.png"
            },
            {
                "bank_no": "970432",
                "name": "Ngân hàng TMCP Việt Nam Thịnh Vượng",
                "short_name": "VPBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/VPBANK.png"
            },
            {
                "bank_no": "970439",
                "name": "Ngân hàng TNHH MTV Public Việt Nam",
                "short_name": "PUBLICBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/PUBLICBANK.png"
            },
            {
                "bank_no": "970415",
                "name": "Ngân hàng TMCP Công Thương Việt Nam",
                "short_name": "VIETINBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/VIETTINBANK.png"
            },
            {
                "bank_no": "970431",
                "name": "Ngân hàng TMCP Xuất nhập khẩu Việt Nam",
                "short_name": "EXIMBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/EXIMBANK.png"
            },
            {
                "bank_no": "970440",
                "name": "Ngân hàng TMCP Đông Nam Á",
                "short_name": "SEABANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/SEABANK.png"
            },
            {
                "bank_no": "970429",
                "name": "Ngân hàng TMCP Sài Gòn",
                "short_name": "SCB",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/SCB.png"
            },
            {
                "bank_no": "970448",
                "name": "Ngân hàng TMCP Phương Đông",
                "short_name": "OCB",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/OCB.png"
            },
            {
                "bank_no": "970425",
                "name": "Ngân hàng TMCP An Bình",
                "short_name": "ABBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/ABBANK.png"
            },
            {
                "bank_no": "970426",
                "name": "Ngân hàng TMCP Hàng Hải Việt Nam",
                "short_name": "MSB",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/MSB.png"
            },
            {
                "bank_no": "970427",
                "name": "Ngân hàng TMCP Việt Á",
                "short_name": "VIETABANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/VIETABANK.png"
            },
            {
                "bank_no": "970419",
                "name": "Ngân hàng TMCP Quốc Dân",
                "short_name": "NCB",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/NCB.png"
            },
            {
                "bank_no": "970418",
                "name": "Ngân hàng TMCP Đầu tư và Phát triển Việt Nam",
                "short_name": "BIDV",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/BIDV.png"
            },
            {
                "bank_no": "970443",
                "name": "Ngân hàng TMCP Sài Gòn - Hà Nội",
                "short_name": "SHB",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/SHB.png"
            },
            {
                "bank_no": "970406",
                "name": "Ngân hàng TMCP Đông Á",
                "short_name": "DONGABANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/DONGABANK.png"
            },
            {
                "bank_no": "970441",
                "name": "Ngân hàng TMCP Quốc Tế",
                "short_name": "VIB",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/VIB.png"
            },
            {
                "bank_no": "970424",
                "name": "Ngân hàng TNHH MTV Shinhan Việt Nam",
                "short_name": "SHINHANBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/SHINHANBANK.png"
            },
            {
                "bank_no": "970433",
                "name": "Ngân hàng TMCP Việt Nam Thương Tín",
                "short_name": "VIETBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/VIETBANK.png"
            },
            {
                "bank_no": "970454",
                "name": "Ngân hàng TMCP Bản Việt",
                "short_name": "VIETCAPITALBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/VIETCAPITALBANK.png"
            },
            {
                "bank_no": "970452",
                "name": "Ngân hàng TMCP Kiên Long",
                "short_name": "KIENLONGBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/KIENLONGBANK.png"
            },
            {
                "bank_no": "970430",
                "name": "Ngân hàng TMCP Xăng Dầu Petrolimex",
                "short_name": "PGBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/PGBANK.png"
            },
            {
                "bank_no": "970400",
                "name": "Ngân hàng TMCP Sài Gòn Công Thương",
                "short_name": "SAIGONBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/SAIGONBANK.png"
            },
            {
                "bank_no": "970405",
                "name": "Ngân hàng Nông Nghiệp và Phát triển Nông Thôn Việt Nam",
                "short_name": "AGRIBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/AGRIBANK.png"
            },
            {
                "bank_no": "970403",
                "name": "Ngân hàng TMCP Sài Gòn Thương Tín",
                "short_name": "SACOMBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/SACOMBANK.png"
            },
            {
                "bank_no": "970412",
                "name": "Ngân hàng TMCP Đại Chúng Việt Nam",
                "short_name": "PVCOMBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/PVCOMBANK.png"
            },
            {
                "bank_no": "970421",
                "name": "Ngân hàng Liên Doanh Việt Nga",
                "short_name": "VRB",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/VRB.png"
            },
            {
                "bank_no": "970428",
                "name": "Ngân hàng TMCP Nam Á",
                "short_name": "NAMABANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/NAMABANK.png"
            },
            {
                "bank_no": "970434",
                "name": "Ngân hàng TNHH Indovina",
                "short_name": "IVB",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/IVB.png"
            },
            {
                "bank_no": "970449",
                "name": "Ngân hàng TMCP Bưu Điện Liên Việt",
                "short_name": "LIENVIETPOSTBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/LienVietPostBank.png"
            },
            {
                "bank_no": "970436",
                "name": "Ngân hàng TMCP Ngoại thương Việt Nam",
                "short_name": "VIETCOMBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/VIETCOMBANK.png"
            },
            {
                "bank_no": "970416",
                "name": "Ngân hàng TMCP Á Châu",
                "short_name": "ACB",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/ACB.png"
            },
            {
                "bank_no": "970458",
                "name": "Ngân hàng TNHH MTV United Overseas Bank",
                "short_name": "UOB",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/UOB.png"
            },
            {
                "bank_no": "970446",
                "name": "Ngân hàng Co-op Bank",
                "short_name": "COOPBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/COOPBANK.png"
            },
            {
                "bank_no": "970455",
                "name": "Ngân hàng IBK - chi nhánh Hà Nội",
                "short_name": "IBK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/Group4916.png"
            },
            {
                "bank_no": "970409",
                "name": "Ngân hàng TMCP Bắc Á",
                "short_name": "BACA",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/BACABANK.png"
            },
            {
                "bank_no": "422589",
                "name": "Ngân hàng TNHH MTV CIMB",
                "short_name": "CIMB",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/Group4899.png"
            },
            {
                "bank_no": "796500",
                "name": "Ngân hàng DBS - Chi nhánh Hồ Chí Minh",
                "short_name": "DBS",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/DBS.png"
            },
            {
                "bank_no": "458761",
                "name": "TNHH MTV HSBC Việt Nam ",
                "short_name": "HSBC",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/HSBC.png"
            },
            {
                "bank_no": "970410",
                "name": "TNHH MTV Standard Chartered Việt Nam",
                "short_name": "SCVN",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/STANDARDCHARTERED.png"
            },
            {
                "bank_no": "801011",
                "name": "Nonghuyp - Chi nhánh Hà Nội",
                "short_name": "NHB",
                "logo_link": null
            },
            {
                "bank_no": "970444",
                "name": "TM TNHH MTV Xây Dựng Việt Nam ",
                "short_name": "CBBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/CBBANK.png"
            },
            {
                "bank_no": "970456",
                "name": " IBK - chi nhánh HCM",
                "short_name": "IBK - HCM",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/Group4916.png"
            },
            {
                "bank_no": "970462",
                "name": "Kookmin - Chi nhánh Hà Nội",
                "short_name": "KBHN",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/Group4918.png"
            },
            {
                "bank_no": "970463",
                "name": "Kookmin - Chi nhánh Thành phố Hồ Chí Minh",
                "short_name": "KBHCM",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/Group4918.png"
            },
            {
                "bank_no": "546034",
                "name": "Ngân hàng số CAKE by VPBank",
                "short_name": "CAKE",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/CAKE.png"
            },
            {
                "bank_no": "546035",
                "name": "Ngân hàng số Ubank by VPBank",
                "short_name": "UBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/Group4884.png"
            },
            {
                "bank_no": "970457",
                "name": "TNHH MTV Woori Việt Nam",
                "short_name": "WOORIBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/WOORIBANK.png"
            },
            {
                "bank_no": "999888",
                "name": "Chính sách Xã hội",
                "short_name": "VBSP",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/Group4914.png"
            },
            {
                "bank_no": "970467",
                "name": "NGÂN HÀNG KEB HANA - CHI NHÁNH HÀ NỘI",
                "short_name": "KEB Hana HN",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/HANABANK.png"
            },
            {
                "bank_no": "971011",
                "name": "Trung tâm dịch vụ tài chính số VNPT – Chi nhánh Tổng công ty truyền thông",
                "short_name": "VNPT Money",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/VNPTMONEY.png"
            },
            {
                "bank_no": "971005",
                "name": "Tổng Công ty Dịch vụ Số Viettel – Chi nhánh Tập đoàn Công nghiệp Viễn thông Quân đội",
                "short_name": "Viettel Money",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/VIETTELMONEY.png"
            },
            {
                "bank_no": "970466",
                "name": "NGÂN HÀNG KEB HANA - CHI NHÁNH THÀNH PHỐ HỒ CHÍ MINH",
                "short_name": "KEB Hana HCM",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/HANABANK.png"
            },
            {
                "bank_no": "668888",
                "name": "Đại chúng TNHH Kasikornbank - Chi nhánh TP. HCM",
                "short_name": "KBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/KASIKORN.png"
            },
            {
                "bank_no": "STANDARDCHARTERED",
                "name": "Ngân hàng STANDARDCHARTERED Việt Nam",
                "short_name": "STANDARDCHARTERED",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/STANDARD%20CHARTERED.png"
            },
            {
                "bank_no": "LPBANK",
                "name": "Ngân hàng LPBANK Việt Nam",
                "short_name": "LPBANK",
                "logo_link": "https://public-cdn.baokim.vn/statics/img/banks/LPBANK.png"
            }
        ]
    }
}