API mở ngân hàng

API mở ngân hàng (Open API) là gì?

Open API (Application Programming Interface) là cầu nối kỹ thuật để các hệ thống phần mềm trao đổi dữ liệu tự động. Trong ngân hàng, Open API cho phép đối tác bên ngoài truy vấn số dư, lịch sử giao dịch, khởi tạo thanh toán, xác minh danh tính… với sự chấp thuận của khách hàng.

Các nhóm API chính theo chuẩn NHNN

• Account Information API (AIS): truy vấn thông tin tài khoản, số dư, lịch sử giao dịch (chỉ đọc).
• Payment Initiation API (PIS): khởi tạo lệnh thanh toán, chuyển tiền từ tài khoản khách hàng.
• Card Issuance API: phát hành và quản lý thẻ.
• KYC/Identity API: xác minh danh tính khách hàng điện tử (eKYC).

Tiêu chuẩn kỹ thuật bắt buộc

• Giao thức RESTful với định dạng JSON.
• Xác thực bằng OAuth 2.0 + JWT, mã hóa TLS 1.3.
• Tài liệu API công khai theo chuẩn OpenAPI 3.0 (Swagger).
• SLA phản hồi: 99,9% uptime, thời gian phản hồi < 500ms cho AIS và < 2 giây cho PIS.

Ví dụ endpoint

GET /v1/accounts/{accountId}/balance – trả về JSON: {"available_balance":"50,000,000 VND","currency":"VND","as_of":"2025-01-15T10:30:00+07:00"}. Mỗi request phải kèm Bearer Token và chữ ký điện tử, mọi log truy cập được lưu trữ tối thiểu 2 năm phục vụ kiểm toán.