FindBSB: API xác thực mã ngân hàng Úc miễn phí dành cho lập trình viên

FindBSB: API xác thực mã ngân hàng Úc miễn phí dành cho lập trình viên

Nếu bạn từng xây dựng biểu mẫu thanh toán, hệ thống tính lương (payroll) hay bất kỳ ứng dụng nào liên quan đến chuyển khoản ngân hàng tại Úc, chắc hẳn bạn đã từng phải đau đầu với các mã số BSB.

BSB (Bank State Branch) là mã gồm 6 chữ số dùng để định danh các chi nhánh ngân hàng tại Úc. Mọi giao dịch nội địa đều cần đến mã này. Tuy nhiên, khá ngạc nhiên khi trước đây chưa có một API miễn phí nào thực sự tốt để xác thực chúng — cho đến khi công cụ này ra đời.

Vấn đề cần giải quyết

Cách đây vài tháng, tôi đang phát triển tính năng thanh toán cho một nền tảng thương mại điện tử. Người dùng tự nhập mã BSB, nhưng chúng tôi không có cách nào để kiểm tra tính chính xác của mã này trước khi gửi dữ liệu sang Stripe.

Các lựa chọn lúc bấy giờ khá hạn chế:

• AusPayNet (nguồn dữ liệu chính thức): Chỉ cung cấp file tải xuống dưới dạng CSV, không có API.
• Các trang tra cứu BSB hiện có: Chỉ cung cấp giao diện người dùng (UI), không có API để tích hợp.
• Tự xây dựng: Phân tích cú pháp file CSV, tự host dữ liệu và xây dựng các endpoint.

Cuối cùng, tôi đã quyết định tự xây dựng giải pháp của riêng mình. Và rồi tôi nghĩ, tại sao không chia sẻ nó cho cộng đồng?

Giải pháp: FindBSB

Tôi đã tạo ra FindBSB — một API JSON miễn phí để tra cứu mã BSB của Úc. Không cần API key, không cần đăng ký tài khoản, chỉ cần sử dụng HTTP thông thường.

Địa chỉ cơ bản: https://findbsb.com.au/api

Tra cứu mã BSB đơn lẻ

Bạn có thể thực hiện truy vấn trực tiếp để lấy thông tin chi tiết của một mã BSB cụ thể.

curl https://findbsb.com.au/api/bsb/062-000

Kết quả trả về sẽ là một đối tượng JSON chi tiết:

{
  "bsb": "062-000",
  "mnemonic": "CBA",
  "bank": "Commonwealth Bank of Australia",
  "branch": "48 Martin Place Sydney",
  "address": "48 Martin Place",
  "suburb": "Sydney",
  "state": "NSW",
  "postcode": "2000",
  "payments": ["paper", "electronic", "cash"],
  "closed": false
}

Lọc theo ngân hàng, bang, vùng ngoại ô

API hỗ trợ các tham số truy vấn để lọc kết quả theo nhu cầu:

curl "https://findbsb.com.au/api/bsb?bank=ANZ&state=NSW&limit=5"

Xác thực hàng loạt (Bulk Validation)

Đây là tính năng tôi tự hào nhất. Bạn có thể dán danh sách mã BSB và nhận lại kết quả đã được làm sạch chỉ trong một lần yêu cầu — hỗ trợ tối đa 500 BSB mỗi yêu cầu.

curl -X POST https://findbsb.com.au/api/validate \
  -H "Content-Type: application/json" \
  -d '{"bsbs": ["062-000", "012-003", "999-999"]}'

Kết quả trả về:

{
  "total": 3,
  "valid": 2,
  "invalid": 1,
  "closed": 1,
  "results": [
    {"bsb": "062-000", "valid": true, "closed": false, "bank": "Commonwealth Bank of Australia", ...},
    {"bsb": "012-003", "valid": true, "closed": true, "bank": "Australia & New Zealand Banking Group", ...},
    {"bsb": "999-999", "valid": false, "error": "not found"}
  ]
}

Ví dụ tích hợp

Với Python

import requests

def validate_bsbs(bsb_list):
    response = requests.post(
        'https://findbsb.com.au/api/validate',
        json={'bsbs': bsb_list},
        headers={'User-Agent': 'MyApp/1.0'}
    )
    return response.json()

result = validate_bsbs(['062-000', '012-003', '999-999'])
print(f"Hợp lệ: {result['valid']}, Không hợp lệ: {result['invalid']}")

Với JavaScript

const res = await fetch('https://findbsb.com.au/api/bsb/062-000');
const bsb = await res.json();
console.log(bsb.bank); // Commonwealth Bank of Australia

Cách hoạt động và Hiệu suất

• Nguồn dữ liệu: Được lấy từ AusPayNet (cơ quan thanh toán chính thức của Úc) với hơn 18.000 mã BSB.
• Cập nhật: Dữ liệu được đồng bộ hàng tháng khi AusPayNet công bố dữ liệu mới.
• Kiến trúc: Hệ thống được xây dựng trên AWS Lambda và API Gateway, được định tuyến qua Cloudflare.
• Giới hạn tốc độ: 30 yêu cầu mỗi phút cho mỗi địa chỉ IP. Nếu cần xác thực hàng loạt, hãy sử dụng endpoint /api/validate.

Tài liệu và Liên kết

Nếu bạn thích hệ sinh thái RapidAPI, công cụ này cũng đã có mặt tại đó với tên gọi FindBSB — Australian BSB Lookup.

Bạn có thể xem tài liệu API đầy đủ và trải nghiệm trực tiếp tại: findbsb.com.au/api/

Rất mong nhận được phản hồi từ các bạn, đặc biệt là nếu có các endpoint hoặc trường dữ liệu nào có thể giúp công cụ này hữu ích hơn cho trường hợp sử dụng của bạn. Tôi sẵn sàng thêm tính năng tìm kiếm theo mã bưu chính, mã SWIFT đi kèm với BSB, hoặc bất kỳ thứ gì còn thiếu sót.