Ngân hàng (VCB, BIDV, MB...)

KOPA hỗ trợ kết nối 8 ngân hàng phổ biến nhất tại Việt Nam, plus các ngân hàng khác qua Casso hoặc file MT940/SWIFT.

Vietcombank (VCB)#

Yêu cầu#

• Tài khoản internet banking VCB Digibank cho doanh nghiệp.
• IP request từ Việt Nam (hoặc dùng KOPA proxy VN).

Cách kết nối#

1. Cài đặt → Connectors → + Thêm → Vietcombank.
2. Nhập số tài khoản + mã CIF.
3. KOPA mở popup OAuth của Digibank.
4. Đăng nhập internet banking.
5. Cấp quyền read-only (xem giao dịch + số dư, không cấp quyền chuyển tiền).
6. Cấp Smart OTP nếu được yêu cầu.

Đồng bộ#

• Real-time webhook cho giao dịch mới.
• Pull lịch sử 90 ngày khi mới connect.
• Refresh token tự động mỗi 30 ngày.

Sự cố thường gặp#

• Lỗi 403 / IP not allowed — IP của bạn ngoài VN. Production KOPA dùng proxy VN tự động; dev local cần VPN.
• Smart OTP timeout — refresh popup, đăng nhập lại.

BIDV#

Tương tự VCB:

• OAuth qua BIDV iBank.
• Real-time webhook.
• Yêu cầu IP VN.

Techcombank (TCB)#

• Connector dùng TCB Business Banking API.
• Cập nhật mỗi 15 phút (không phải real-time).
• Hỗ trợ cả VND và ngoại tệ.

VPBank (VPB)#

• Connector dùng VPB Online for Corporate.
• Pull mỗi 15 phút.
• Hỗ trợ thẻ tín dụng doanh nghiệp.

MBBank (MB)#

• MB SmartBank Open API.
• Real-time webhook.
• Hỗ trợ tài khoản VND, USD, EUR.

ACB / Sacombank / OCB / MSB qua Casso#

Casso là middleware kết nối nhiều ngân hàng VN qua một API.

Cách kết nối qua Casso#

1. Đăng ký account tại casso.vn.
2. Add tài khoản ngân hàng vào Casso.
3. Lấy Casso webhook secret + API key.
4. Trong KOPA: Connectors → + Thêm → Casso → dán key.
5. KOPA tạo webhook URL — copy và add vào Casso.

Lưu ý: Casso có phí ~150,000 VND/tháng/tài khoản. Phí Casso, không phải KOPA.

File MT940 / SWIFT (manual)#

Cho các ngân hàng không hỗ trợ API (đa số ngân hàng quốc tế phục vụ FDI).

Quy trình#

1. Đăng nhập internet banking ngân hàng → xuất sao kê dạng MT940 hoặc SWIFT.
2. Vào KOPA: Connectors → + Thêm → MT940 Import.
3. Upload file.
4. KOPA parse và preview giao dịch.
5. Bấm Confirm → giao dịch import vào Banking.

Mapping tài khoản#

Mỗi tài khoản ngân hàng cần map với TK kế toán:

• VCB → 1121 (Tiền gửi VCB).
• BIDV → 1122 (Tiền gửi BIDV).
• USD VCB → 1123 (Tiền gửi USD VCB).

KOPA tự gợi ý theo Master Data, có thể chỉnh.

Auto-categorization#

Sau khi giao dịch về, KOPA tự phân loại memo:

• "CK CK NGUYEN VAN A 1234" → KH ABC, thu tiền.
• "PAYROLL T04/2024" → Lương, chi.
• "MB BANK INTEREST" → Lãi tiền gửi.

Đọc chi tiết ở Memo parsing.

Thanh toán & chuyển tiền#

KOPA không trực tiếp chuyển tiền. Quy trình:

1. KOPA đề xuất bút toán cần thanh toán.
2. Bạn duyệt.
3. KOPA sinh lệnh chuyển khoản (file batch theo định dạng ngân hàng).
4. Bạn upload file vào internet banking và confirm thủ công.

Lý do: bảo mật. KOPA không cần quyền chuyển tiền.