RPA / đồng bộ lịch

API MSB

MSB (Maritime Bank) được Casso kết nối trên Flow theo cơ chế RPA, đồng bộ sao kê theo lịch.

BIN VietQR: 970426
Mã: MSB
SWIFT: MCOBVNVX
Pháp nhân: Ngân hàng TMCP Hàng Hải Việt Nam

Kết nối trên Flow

Casso làm gì với tài khoản MSB

Casso đọc sao kê MSB 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.

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.

Bot và webhook

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.

Xác nhận đơn CK

Khớp số tiền + nội dung chuyển khoản với đơn WooCommerce / webhook tùy chỉnh.

Chỉ đọc

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.

Hai API hay bị nhầm

Casso

Lịch sử giao dịch & webhook

Sau khi liên kết TK MSB 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)

Ảnh QR chuyển khoản

BIN 970426 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/970426-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

Danh sách API MSB

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 MSB trên Flow.

GET

API thông tin ngân hàng

Danh sách ngân hàng VietQR. Object dưới đây là bản ghi MSB trong kết quả.

URL

https://api.vietqr.io/v2/banks

JSONmsb.json

{
  "name": "Ngân hàng TMCP Hàng Hải Việt Nam",
  "code": "MSB",
  "bin": "970426",
  "shortName": "MSB",
  "logo": "https://api.vietqr.io/img/MSB.png",
  "transferSupported": 1,
  "lookupSupported": 1,
  "short_name": "MSB",
  "swift_code": "MCOBVNVX"
}

BIN: 970426
Mã: MSB
SWIFT: MCOBVNVX
Napas: Có

Website: https://www.msb.com.vn/

GET

API tạo mã VietQR cho MSB

Ảnh QR chuyển khoản NAPAS. ACCOUNT_NO là số tài khoản; TEMPLATE gồm qr_only, compact, compact2.

URLtheo tên NH

https://img.vietqr.io/image/msb-<ACCOUNT_NO>-<TEMPLATE>.png

URLtheo BIN

https://img.vietqr.io/image/970426-<ACCOUNT_NO>-<TEMPLATE>.png

HTML

<img src="https://img.vietqr.io/image/970426-8888888-compact.png" alt="VietQR MSB" />

Ví dụ VietQR MSB — Ví dụ compact · STK 8888888

Chi tiết template: vietqr.io

POST

API tra cứu số tài khoản

Tra tên chủ TK MSB 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

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": "970426",
    "accountNumber": "222777313"
  }'

GET

API truy vấn lịch sử giao dịch

Đây là API của Casso: đọc sao kê tài khoản MSB đã liên kết trên Flow. Không phải API public của ngân hàng.

Liên kết tài khoản MSB vào Casso Flow
Tạo API Key hoặc OAuth2 trên Casso
Gọi REST bên dưới (hoặc nhận webhook khi có GD mới)

cURL

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>'

JSONresponse.json

{
  "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

Developer portal MSB

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.

MSB 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.

Ngân hàng khác

Tất cả API ngân hàng →

Casso làm gì với tài khoản MSB

Casso đọc sao kê MSB 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.

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.

Bot và webhook

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.

Xác nhận đơn CK

Khớp số tiền + nội dung chuyển khoản với đơn WooCommerce / webhook tùy chỉnh.

Chỉ đọc

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.

Hai API hay bị nhầm

Casso

Lịch sử giao dịch & webhook

Sau khi liên kết TK MSB 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)

Ảnh QR chuyển khoản

BIN 970426 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/970426-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/.

Danh sách API MSB

GET

API thông tin ngân hàng

Danh sách ngân hàng VietQR. Object dưới đây là bản ghi MSB trong kết quả.

URL

https://api.vietqr.io/v2/banks

JSONmsb.json

{
  "name": "Ngân hàng TMCP Hàng Hải Việt Nam",
  "code": "MSB",
  "bin": "970426",
  "shortName": "MSB",
  "logo": "https://api.vietqr.io/img/MSB.png",
  "transferSupported": 1,
  "lookupSupported": 1,
  "short_name": "MSB",
  "swift_code": "MCOBVNVX"
}

BIN: 970426
Mã: MSB
SWIFT: MCOBVNVX
Napas: Có

Website: https://www.msb.com.vn/

GET

API tạo mã VietQR cho MSB

Ảnh QR chuyển khoản NAPAS. ACCOUNT_NO là số tài khoản; TEMPLATE gồm qr_only, compact, compact2.

URLtheo tên NH

https://img.vietqr.io/image/msb-<ACCOUNT_NO>-<TEMPLATE>.png

URLtheo BIN

https://img.vietqr.io/image/970426-<ACCOUNT_NO>-<TEMPLATE>.png

HTML

<img src="https://img.vietqr.io/image/970426-8888888-compact.png" alt="VietQR MSB" />

Chi tiết template: vietqr.io

POST

API tra cứu số tài khoản

Tra tên chủ TK MSB 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

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": "970426",
    "accountNumber": "222777313"
  }'

GET

API truy vấn lịch sử giao dịch

Đây là API của Casso: đọc sao kê tài khoản MSB đã liên kết trên Flow. Không phải API public của ngân hàng.

Liên kết tài khoản MSB vào Casso Flow
Tạo API Key hoặc OAuth2 trên Casso
Gọi REST bên dưới (hoặc nhận webhook khi có GD mới)

cURL

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>'

JSONresponse.json

{
  "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

Developer portal MSB

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.

MSB 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.