Sao kê vào Flow
Giao dịch ghi có / ghi nợ của tài khoản đã liên kết xuất hiện trên Casso — không xuất file từ Internet Banking.
Official API
BIDV thuộc nhóm NHTM lớn. Casso là đối tác API — biến động số dư vào Flow realtime, chỉ đọc sao kê.
Casso đọc sao kê BIDV rồi đẩy sự kiện vào chỗ bạn làm việc. Không phải cổng chuyển tiền, không phải API VietQR.
Giao dịch ghi có / ghi nợ của tài khoản đã liên kết xuất hiện trên Casso — không xuất file từ Internet Banking.
Bắn biến động vào Telegram, Slack, Discord hoặc API của bạn ngay khi Casso nhận được giao dịch mới.
Khớp số tiền + nội dung chuyển khoản với đơn WooCommerce / webhook tùy chỉnh.
Casso không chuyển tiền, không đổi hạn mức. Lệnh chi vẫn cần OTP ngân hàng của bạn.
Casso
Sau khi liên kết TK BIDV trên Flow, tạo API key hoặc OAuth. Gọi REST / nhận webhook mỗi giao dịch mới. Đây là API của Casso, không phải API public của ngân hàng.
developer.casso.vn →VietQR (công khai)
BIN 970418 dùng để tạo QR NAPAS. Không thay cho việc Casso đọc sao kê. Tài liệu và danh sách bank: vietqr.io.
https://img.vietqr.io/image/970418-SO_TAI_KHOAN-compact.png
vietqr.io →Hướng dẫn gắn tài khoản: docs.casso.vn. Bảng giá theo loại kết nối: /flow/bang-gia/.
Tài liệu API
Các endpoint công khai trên trang gốc WordPress, sắp lại cho dễ đọc. VietQR là API của NAPAS/VietQR; lịch sử giao dịch là API của Casso sau khi bạn đã liên kết tài khoản BIDV trên Flow.
Danh sách ngân hàng VietQR. Object dưới đây là bản ghi BIDV trong kết quả.
https://api.vietqr.io/v2/banks{
"name": "Ngân hàng TMCP Đầu tư và Phát triển Việt Nam",
"code": "BIDV",
"bin": "970418",
"shortName": "BIDV",
"logo": "https://api.vietqr.io/img/BIDV.png",
"transferSupported": 1,
"lookupSupported": 1,
"short_name": "BIDV",
"swift_code": "BIDVVNVX"
}Website: https://www.bidv.com.vn/
Ảnh QR chuyển khoản NAPAS. ACCOUNT_NO là số tài khoản; TEMPLATE gồm qr_only, compact, compact2.
ACB
Agribank
Eximbank
MB Bank
MSB
OCB
Techcombank
Timohttps://img.vietqr.io/image/bidv-<ACCOUNT_NO>-<TEMPLATE>.pnghttps://img.vietqr.io/image/970418-<ACCOUNT_NO>-<TEMPLATE>.png<img src="https://img.vietqr.io/image/970418-8888888-compact.png" alt="VietQR BIDV" />
Chi tiết template: vietqr.io
Tra tên chủ TK BIDV theo BIN + số tài khoản. Cần x-api-key và x-client-id từ VietQR — không phải API key Casso.
curl --location --request POST 'https://api.vietqr.io/v2/lookup' \
--header 'x-api-key: <VIETQR_API_KEY>' \
--header 'x-client-id: <VIETQR_CLIENT_ID>' \
--header 'Content-Type: application/json' \
--data-raw '{
"bin": "970418",
"accountNumber": "222777313"
}'Đây là API của Casso: đọc sao kê tài khoản BIDV đã liên kết trên Flow. Không phải API public của ngân hàng.
curl --location --request GET 'https://oauth.casso.vn/v2/transactions?fromDate=2021-04-01&page=1&pageSize=20&sort=ASC' \
--header 'Authorization: Apikey <CASSO_API_KEY>'
# Hoặc OAuth2:
# --header 'Authorization: Bearer <ACCESS_TOKEN>'{
"error": 0,
"message": "Success",
"data": {
"page": 1,
"pageSize": 20,
"records": [
{
"id": 123456,
"tid": "FT21001ABC",
"description": "CT DEN: nguyen van a chuyen khoan",
"amount": 150000,
"cusum_balance": 12500000,
"when": "2021-04-01 09:15:00",
"bank_sub_acc_id": "8888888"
}
]
}
}Tài liệu đầy đủ: developer.casso.vn
Cổng Open API do ngân hàng tự công bố (nếu có). Khác với API Casso và VietQR ở trên.
BIDV chưa công bố developer portal công khai trên trang gốc. Dùng API Casso + VietQR như các mục trên.
Vietcombank
VietinBank
VPBank