Đến nội dung
BankGateway
Console ↗
Tìm kiếm tài liệu & API
Bắt đầu
Tổng quan dịch vụ

Cổng API Tra cứu số tài khoản Napas 24/7 theo chuẩn OpenBanking quốc tế. Độ trễ cực thấp O(1) Cache, xác thực Zero-Trust và chữ ký số Ed25519.

Bắt đầu
Bắt đầu nhanh (Quickstart)

Hướng dẫn thực hiện cuộc gọi API tra cứu số tài khoản đầu tiên trong vòng 3 phút bằng cURL, Node.js hoặc Python.

Xác thực & Bảo mật
Xác thực API Key

Cơ chế bảo mật Server-to-Server bằng Header X-API-Key, nguyên tắc giữ bí mật và quy trình thu hồi / cấp phát lại khóa.

Xác thực & Bảo mật
Chữ ký số Ed25519

Đảm bảo tính toàn vẹn và chống giả mạo dữ liệu ngân hàng bằng chữ ký mật mã Ed25519 đính kèm trong mỗi phản hồi.

Xác thực & Bảo mật
Chống trùng lặp (Idempotency)

Sử dụng Header Idempotency-Key chuẩn RFC 8470 để đảm bảo không bị trừ tiền hai lần khi mạng chập chờn hoặc retry.

API Tra cứu ngân hàngPOST
Tra cứu tài khoản

Đặc tả kỹ thuật Endpoint POST /api/v1/lookup. Tra cứu thời gian thực tên chủ tài khoản ngân hàng.

API Tra cứu ngân hàngPOST
Tra cứu theo lô & Webhook

Gửi danh sách hàng nghìn STK trong một request, nhận thông báo kết quả bất đồng bộ qua Webhook kèm chữ ký số.

API Tra cứu ngân hàngGET
Danh sách 68 ngân hàng

Danh mục mã ngân hàng (bankCode), mã BIN Napas, tên đầy đủ và tình trạng kết nối thời gian thực.

↑ ↓ Điều hướng↵ ChọnEsc Đóng
Mục lục tài liệu:Danh sách 68 ngân hàng ▾
Tài liệu/API Tra cứu ngân hàng

Bảng mã 68 Ngân hàng / Công ty tài chính và mã BIN định tuyến Napas.

GET/api/v1/banksX-API-Key

Lấy danh sách ngân hàng qua API

cURL
curl -X GET 'https://api.bankgateway.org/api/v1/banks'

Trả về danh sách các ngân hàng, mã `bankCode`, mã BIN Napas, tên ngắn/đầy đủ và trạng thái kết nối hiện tại.

Tra cứu danh mục tương tác

34 / 34 ngân hàng tham khảo
BANK CODENGÂN HÀNGBINALIAS
MBMBBank970422MBBANK
VCBVietcombank970436VIETCOMBANK
TCBTechcombank970407TECHCOMBANK
CTGVietinBank970415VIETINBANK
BIDVBIDV970418—
VBAAgribank970405AGRIBANK
ACBACB970416—
VPBVPBank970432VPBANK
TPBTPBank970423TPBANK
STBSacombank970403SACOMBANK
HDBHDBank970437HDBANK
VIBVIB970441—
SHBSHB970443—
MSBMSB970426—
LPBLPBank970449LIENVIETPOSTBANK
OCBOCB970448—
EIBEximbank970431EXIMBANK
SEABSeABank970440SSB, SEABANK
BABBac A Bank970409BACA
NABNam A Bank970428NAMABANK
BVBBaoViet Bank970438BAOVIET
KLBKienlongBank970452KIENLONG
PGBPGBank970430PGBANK
ABBABBANK970425ABBANK
NVBNCB970419NCB
SGBSaigonBank970400SAIGONBANK
PVBPVcomBank970412PVCOMBANK
VABViet A Bank970427VIETABANK
VCCBBVBank970454BVBANK, VIETCAPITALBANK
VIETBANKVietBank970433—
SCBSCB970429—
COOPBANKCo-opBank970446—
SHBVNShinhan Bank Vietnam970424—
WVNWoori Bank Vietnam970457—

Danh mục tham khảo được chọn lọc theo mã gateway chấp nhận; không phải danh sách khả dụng theo thời gian thực.

Top ngân hàng phổ biến nhất

Mã gửi API (bankCode)Tên ngân hàngMã BIN Napas
MBMBBank (Ngân hàng Quân Đội)970422
VCBVietcombank (Ngoại Thương Việt Nam)970436
TCBTechcombank (Kỹ Thương Việt Nam)970407
CTGVietinBank (Công Thương Việt Nam)970415
BIDVBIDV (Đầu Tư & Phát Triển Việt Nam)970418
ACBACB (Á Châu)970416
VPBVPBank (Việt Nam Thịnh Vượng)970432
TPBTPBank (Tiên Phong)970423
STBSacombank (Sài Gòn Thương Tín)970403
HDBHDBank (Phát Triển TP.HCM)970437
Tài liệu phát hành theo chuẩn OpenBanking 2.0 · Cập nhật v1.0.5 (Chính thức)Góp ý tài liệu & Báo lỗi ↗