Tiện ích trình duyệt

Tiện ích BankOpenAPI cho người bán dành cho người chốt đơn trong khung chat. Bấm đúp vào số tiền như "150k" rồi nhấn Alt+Q: ảnh mã QR đúng số tiền nằm sẵn trong ô chat, chỉ còn nhấn Enter. Khách chuyển khoản xong, máy tính đọc "Đã nhận một trăm năm mươi nghìn đồng" và mã chuyển sang "Đã thanh toán", không cần mở app ngân hàng hay tab nào.

Miễn phí, bản 0.2.1. Cài được trên Chrome, Microsoft Edge và Cốc Cốc; trình duyệt tự cập nhật khi có bản mới.

Tính năng

Tạo mã từ khung chat: bấm đúp vào số tiền trên Messenger, Zalo, Pancake, Instagram, TikTok hay trang bất kỳ rồi nhấn Alt+Q, hoặc bôi đen rồi chuột phải → "Tạo mã thu tiền". Ảnh mã được đưa thẳng vào ô soạn tin.
Ảnh để dán: số tiền, mã QR, ngân hàng, số tài khoản, tên chủ tài khoản, nội dung chuyển khoản. Khách quét bằng app ngân hàng là đúng số tiền, đúng nội dung.
Link thanh toán: cho khách mở trên điện thoại, trang tự báo khi khách trả xong.
Tự xác nhận: danh sách mã đã tạo tự đổi trạng thái (chờ thanh toán, đã thanh toán, thiếu tiền, hết hạn).
Loa báo có: tiền vào bất kỳ tài khoản nào đã liên kết là có thông báo, âm "ting ting", đọc to số tiền; biểu tượng tiện ích ghi tổng tiền về hôm nay.

Yêu cầu

Trình duyệt	Chrome, Microsoft Edge, Cốc Cốc bản mới (từ Chromium 116), trên Windows, macOS hoặc Linux
Tài khoản	Tài khoản BankOpenAPI (chưa có thì đăng ký). Dùng thử Sandbox được ngay, không cần ngân hàng
Chế độ Live	Ít nhất một tài khoản ngân hàng đã liên kết ở trang Tài khoản ngân hàng

Cài đặt

Mở trang tiện ích BankOpenAPI cho người bán trên Chrome Web Store.
Edge, lần đầu cài tiện ích từ Chrome Web Store: trên cùng trang hiện dải thông báo về tiện ích từ cửa hàng khác, bấm nút cho phép trong dải đó rồi chọn Cho phép. Chrome và Cốc Cốc bỏ qua bước này.
Bấm Thêm vào Chrome (Add to Chrome), rồi Thêm tiện ích trong hộp thoại hỏi quyền.
Bấm biểu tượng mảnh ghép trên thanh công cụ → ghim BankOpenAPI cho người bán để biểu tượng luôn hiện.

Cài xong thì sang bước Kết nối tài khoản. Bản cài từ Chrome Web Store tự cập nhật, không phải làm gì thêm.

Cài bằng file zip

Chỉ dùng khi máy không vào được Chrome Web Store (vd. công ty chặn cửa hàng tiện ích). Bản này cùng tính năng nhưng không tự cập nhật. Đã cài từ Chrome Web Store thì không cài thêm bản này: hai bản cùng chạy thì mỗi lần tiền về máy đọc hai lần.

Tải file zip (bản 0.2.1)

Giải nén file vừa tải (Windows: chuột phải vào file → Extract All). Bạn được một thư mục có file manifest.json.
Đặt thư mục đó ở chỗ cố định, ví dụ trong Documents. Xóa hay đổi tên thư mục là tiện ích ngừng chạy.
Mở trang tiện ích của trình duyệt: Chrome gõ chrome://extensions, Edge gõ edge://extensions, Cốc Cốc gõ coccoc://extensions vào thanh địa chỉ.
Bật Developer mode (Chế độ dành cho nhà phát triển), ở góc trên bên phải trên Chrome, Cốc Cốc, ở cột bên trái trên Edge.
Bấm Load unpacked (Tải tiện ích đã giải nén) rồi chọn thư mục vừa giải nén.
Ghim biểu tượng tiện ích như bước 4 ở trên.

Edge có thể hỏi "Tắt tiện ích ở chế độ nhà phát triển" mỗi lần mở: chọn giữ lại. Cảnh báo này có với mọi tiện ích cài tay; bản cài từ Chrome Web Store không bị hỏi.

Kết nối tài khoản

Bấm biểu tượng tiện ích để mở bảng bên, chọn "Kết nối tài khoản BankOpenAPI" (chế độ Live) hoặc "Dùng thử với Sandbox". Một cửa sổ mở trang BankOpenAPI: đăng nhập, xem quyền tiện ích xin rồi bấm "Cho phép kết nối". Cửa sổ tự đóng, tiện ích sẵn sàng.

Kết nối tạo một API key quyền "Tiện ích" tên "Tiện ích trình duyệt – Chrome" (hoặc Edge, Cốc Cốc). Khóa này tạo và xem mã do chính tiện ích tạo, đọc danh sách tài khoản nhận tiền và nhận thông báo tiền về; không đọc được lịch sử giao dịch, số dư, nội dung chuyển khoản hay người chuyển, không đổi được cài đặt hay khóa khác. Khóa hiện ở trang API key, thu hồi ở đó là tiện ích ngắt kết nối.

Chưa có tài khoản: đăng ký và xác minh email trước, rồi quay lại bấm kết nối.

Tạo mã thu tiền

Từ khung chat (nhanh nhất):

Bấm đúp vào số tiền trong tin nhắn (vd. "350k") để bôi đen. Số tiền có dấu cách như "1 triệu 5" thì kéo chuột bôi đen.
Nhấn Alt+Q, hoặc chuột phải → "Tạo mã thu tiền".
Ảnh mã QR nằm sẵn trong ô soạn tin, góc dưới trang hiện "Đã đưa mã QR vào ô chat". Nhấn Enter để gửi. Trang chat không nhận ảnh dán tự động thì ảnh đã được sao chép: bấm vào ô chat rồi nhấn Ctrl+V (macOS: ⌘+V).

Không muốn tự dán: bánh răng → tắt "Tự dán vào ô chat", ảnh chỉ được sao chép. Đổi phím tắt: gõ chrome://extensions/shortcuts (Edge: edge://extensions/shortcuts) vào thanh địa chỉ. Bảng bên luôn hiện mã vừa tạo, có nút "Sao chép ảnh", "Sao chép link" và tải ảnh.

Gõ tay: nhập số tiền và ghi chú (tùy chọn, hiện trên ảnh, vd. "Đơn của chị Lan") ở khung "Tạo mã thu tiền" trong bảng bên.

Số tiền gõ như khi chat:

Bạn bôi đen hoặc gõ	Số tiền
150k, 150K, 150 nghìn, 150 ngàn	150.000 ₫
1tr5, 1,5tr, 1.5 triệu	1.500.000 ₫
1tr25	1.250.000 ₫
2 củ	2.000.000 ₫
150.000, 150.000đ, 150,000 VND	150.000 ₫
ok chị, 350k nhé	350.000 ₫ (lấy số tiền đầu tiên trong câu)
150 (số trần dưới 1.000)	Điền sẵn 150.000 ₫ để bạn kiểm tra, không tự tạo mã

Mỗi mã có nội dung chuyển khoản riêng (dạng TT7K3M9Q) và có hạn thanh toán 24 giờ. Ngoài ảnh còn có "Sao chép link" (trang thanh toán cho khách mở trên điện thoại) và nút tải ảnh về máy. Có nhiều tài khoản ngân hàng thì chọn tài khoản nhận tiền ngay trong khung tạo mã.

Loa báo có

Khi tiền vào bất kỳ tài khoản nào đã liên kết, tiện ích hiện thông báo, phát âm "ting ting" rồi đọc "Đã nhận … đồng", kể cả khi bạn đã đóng mọi cửa sổ trình duyệt: trình duyệt chạy ngầm dưới khay hệ thống (mục chạy ứng dụng nền trong Cài đặt → Hệ thống của trình duyệt, mặc định bật). Biểu tượng tiện ích ghi tổng tiền về hôm nay (vd. 150k, 1tr2); thẻ "Tiền về hôm nay" trong bảng bên liệt kê từng lần.

Đọc số tiền cần giọng tiếng Việt trên máy. Máy chưa có thì tiện ích chỉ phát âm báo và hiện thông báo:

Trình duyệt	Giọng tiếng Việt
Microsoft Edge	Thường có sẵn giọng tiếng Việt trực tuyến của Microsoft (cần mạng), không phải cài thêm.
Chrome, Cốc Cốc trên Windows	Cài giọng "Microsoft An": Cài đặt → Thời gian và ngôn ngữ → Giọng nói → Thêm giọng → Tiếng Việt, rồi mở lại trình duyệt.
Chrome trên macOS	Cài đặt hệ thống → Trợ năng → Nội dung được đọc → Giọng hệ thống → Quản lý giọng → Tiếng Việt, rồi mở lại trình duyệt.

Trong bảng bên, bấm biểu tượng bánh răng: bật tắt đọc số tiền và âm báo, chọn giọng, "Nghe thử" (đọc ngay trên máy) và "Gửi thử" (gửi một thông báo qua máy chủ, để kiểm cả đường nhận thông báo).

Thử bằng Sandbox

Kết nối bằng "Dùng thử với Sandbox". Chưa có tài khoản ngân hàng thử thì BankOpenAPI tạo sẵn một tài khoản.
Bôi đen "150k" ở trang bất kỳ, bấm chuột phải → "Tạo mã thu tiền".
Bấm "Giả lập khách chuyển tiền" dưới ảnh mã: mã chuyển "Đã thanh toán", máy báo và đọc số tiền như tiền thật.
Dùng tiền thật: bánh răng → "Chuyển sang Live".

Mã Sandbox có nhãn SANDBOX trên ảnh, không chuyển tiền thật được.

Cập nhật

Cài từ Chrome Web Store thì trình duyệt tự cập nhật, giữ nguyên kết nối và cài đặt loa. Số phiên bản đang dùng hiện ngay dưới chữ BankOpenAPI trên bảng bên.

Bản cài bằng file zip không tự cập nhật: khi có bản mới, cạnh số phiên bản hiện nút "Cập nhật" mở trang này. Nên chuyển hẳn sang bản trên Chrome Web Store để về sau khỏi phải làm tay:

Trong bảng bên, bấm bánh răng → "Ngắt kết nối".
Gỡ tiện ích ở trang tiện ích của trình duyệt, xóa thư mục đã giải nén.
Cài từ Chrome Web Store theo mục Cài đặt, kết nối lại và chọn lại giọng đọc, âm báo.

Máy không vào được Chrome Web Store thì cập nhật bản zip mà không phải kết nối lại:

Tải file zip mới và giải nén.
Chép toàn bộ file trong thư mục mới đè lên thư mục tiện ích đang dùng (thư mục bạn đã chọn khi cài).
Mở trang tiện ích của trình duyệt, bấm nút tải lại (mũi tên vòng tròn) ở thẻ BankOpenAPI.

Quyền và dữ liệu

Quyền	Để làm gì
Menu chuột phải, phím tắt	Lệnh "Tạo mã thu tiền" và phím Alt+Q.
Trang đang mở (activeTab, scripting)	Chỉ khi bạn nhấn phím tắt hoặc chọn lệnh chuột phải, và chỉ trên trang đó: đọc đoạn chữ đang bôi đen, đưa ảnh mã vào ô chat. Không đọc trang nào khác, không chạy ngầm trên trang.
Chạy nền	Giữ trình duyệt chạy ngầm dưới khay hệ thống để loa vẫn báo khi bạn đã đóng mọi cửa sổ.
Bảng bên (side panel)	Giao diện chính của tiện ích.
Lưu trữ	Lưu kết nối, cài đặt loa, tổng tiền về hôm nay, ngay trên máy của bạn.
Thông báo, đọc văn bản, âm thanh	Báo và đọc số tiền khi có tiền vào.
Đăng nhập (identity)	Mở cửa sổ kết nối với tài khoản BankOpenAPI.
Hẹn giờ	Đặt lại tổng tiền về hôm nay lúc 0 giờ.
Truy cập mạng	Chỉ app.bankopenapi.com (API BankOpenAPI) và bankopenapi.com/downloads (bản cài bằng file zip kiểm tra bản mới).

Tiện ích không đọc tin nhắn hay danh sách khách của bạn. Nó chỉ đọc đoạn chữ bạn bôi đen, lúc bạn nhấn phím tắt hoặc chọn lệnh chuột phải.
Thông báo tiền về chỉ gồm số tiền, ngân hàng, số tài khoản đã che và giờ; không có nội dung chuyển khoản hay tên người chuyển.
API key lưu trong vùng lưu trữ riêng của tiện ích trên máy bạn, trang web khác không đọc được.

Ngắt kết nối, gỡ cài đặt

Bánh răng → "Ngắt kết nối": API key của tiện ích bị thu hồi, máy thôi nhận thông báo. Sau đó gỡ tiện ích ở trang tiện ích của trình duyệt (bản cài bằng file zip thì xóa cả thư mục). Gỡ mà chưa ngắt kết nối thì thu hồi khóa "Tiện ích trình duyệt" ở trang API key.

Xử lý sự cố

Không thấy lệnh "Tạo mã thu tiền". Lệnh chỉ hiện khi có chữ đang được bôi đen. Một số ô chat tự bỏ chọn khi bấm chuột phải: dùng phím Alt+Q.

Nhấn Alt+Q không có gì xảy ra. Phím đang bị tiện ích khác dùng: mở chrome://extensions/shortcuts và đặt phím khác cho BankOpenAPI. Không có chữ nào đang bôi đen thì phím tắt chỉ mở bảng bên để bạn gõ số tiền.

Không có thông báo hay tiếng khi tiền về. Trình duyệt phải đang chạy, kể cả chạy ngầm; thoát hẳn trình duyệt hay tắt máy thì không báo. Bấm "Gửi thử" trong cài đặt: có thông báo mà không có tiếng thì kiểm âm lượng và giọng đọc; không có thông báo thì bật thông báo cho trình duyệt trong cài đặt của Windows hoặc macOS và tắt chế độ Không làm phiền. Brave tắt thông báo đẩy mặc định nên không nhận được.

Đã có thông báo trước đó mà giờ không còn. Báo có đang tạm dừng vì hết 100 giao dịch miễn phí của tháng và số dư bằng 0: nạp tiền trong app là báo lại, cả ở tiện ích lẫn các kênh khác.

"Sao chép ảnh" báo lỗi. Bấm vào bảng bên một lần rồi bấm lại, hoặc dùng nút tải ảnh rồi gửi file. Ứng dụng chat không nhận ảnh dán thì gửi "Sao chép link".

Chế độ Live mà báo "Chưa có tài khoản ngân hàng nhận tiền". Liên kết tài khoản ở trang Tài khoản ngân hàng, hoặc bạn đang ở Sandbox: xem nhãn cạnh logo trên bảng bên.

Vẫn vướng thì gửi email tới teams@bankopenapi.com kèm tên trình duyệt và thời điểm xảy ra. Tiện ích dùng cùng API với yêu cầu thanh toán.