Bỏ qua tới nội dung chính
Open API chính thức BIDV

Biến động số dư ngân hàng, đến hệ thống của bạn trong vài giây.

TinoPay kết nối Open API chính thức của BIDV và đẩy từng giao dịch tới webhook, Telegram, Lark hoặc Google Sheets ngay khi tiền về — kèm tài khoản định danh để mỗi đơn hàng tự đối soát.

  • Không cần mật khẩu ngân hàng
  • Đăng nhập bằng tài khoản Tino
  • Webhook tự gửi lại khi lỗi

Kết nối trực tiếp

Qua Open API chính thức do ngân hàng cung cấp.

  • BIDV Đang hoạt động
  • Ngân hàng tiếp theo Sắp ra mắt
  • Ngân hàng tiếp theo Sắp ra mắt
  • Ngân hàng tiếp theo Sắp ra mắt
  • Ngân hàng tiếp theo Sắp ra mắt
Mật khẩu ngân hàng cần chia sẻ
0
Tự gửi lại khi webhook lỗi
5 phút
Kênh nhận: Webhook · Telegram · Lark · Sheets
4
Tra cứu mỗi lần gọi API
90 ngày

Tính năng

Mọi thứ để nhận tiền và đối soát tự động

Một kết nối BIDV, nhiều cách nhận dữ liệu: webhook cho dev, Telegram và Lark cho vận hành, Google Sheets cho kế toán.

Webhook cho lập trình viên

JSON POST tới URL của bạn ngay khi có giao dịch, xác thực bằng header ALLPAY-TOKEN hoặc Authorization: Apikey <token>.

  • Lọc tiền vào / ra
  • Lọc theo VA
  • Bỏ qua giao dịch không có mã
  • Tự gửi lại sau 5 phút
Tài liệu webhook

Open API chính thức BIDV

Nhận biến động số dư realtime từ tài khoản doanh nghiệp BIDV, không cần chia sẻ mật khẩu ngân hàng.

Tự tách mã thanh toán

Trích mã đơn hàng từ nội dung chuyển khoản vào field code.

"DH12345 chuyen tien mua hang"

code → "DH12345"

Thông báo Telegram & Lark

Báo tiền vào, tiền ra tức thì vào nhóm chat của đội vận hành và kế toán.

Tài khoản định danh (VA)

Tạo nhiều số VA dưới một tài khoản BIDV — mỗi đơn hàng, cửa hàng hay khách hàng một số riêng. Tiền vẫn về tài khoản chính, giao dịch tự khớp theo VA.

REST API

Lịch sử giao dịch (lọc theo ngày, loại, từ khoá, phân trang), danh sách ngân hàng và tạo ảnh QR VietQR.

Tài liệu API

Một tài khoản Tino

Đăng nhập bằng tài khoản Tino, quản lý dịch vụ ngay trong trang khách hàng Tino.

Cách hoạt động

Bắt đầu trong 4 bước

Từ lúc đăng nhập tới giao dịch đầu tiên, mọi thao tác đều nằm trên dashboard TinoPay.

  1. 1

    Đăng nhập bằng tài khoản Tino

    Dùng luôn tài khoản Tino hiện có. Dịch vụ TinoPay được quản lý ngay trong trang khách hàng Tino.

  2. 2

    Liên kết tài khoản BIDV

    Kết nối qua Open API chính thức của BIDV dành cho doanh nghiệp — không nhập mật khẩu ngân hàng.

  3. 3

    Tạo VA & cấu hình webhook

    Tạo số định danh cho từng đơn hàng, cửa hàng hoặc khách; khai báo URL webhook, token và bộ lọc.

  4. 4

    Nhận giao dịch realtime

    Mỗi khoản tiền vào/ra được đẩy tới webhook, Telegram, Lark hoặc Google Sheets ngay khi ngân hàng ghi nhận.

Dành cho Dev

Một endpoint, một token — xong phần tích hợp

Payload JSON gọn, đủ trường để khớp đơn: số tiền, mã thanh toán đã tách sẵn và VA nhận tiền.

{
  "transaction_id": "20251020083338000006",
  "gateway": "BIDV",
  "transactionDate": "2026-10-20 08:33:38",
  "accountNumber": "96247100868",
  "code": "DH12345",
  "content": "DH12345 chuyen tien mua hang",
  "transferType": "in",
  "transferAmount": 150000,
  "referenceCode": "0551dTCO-82LiomOss",
  "virtualAccount": "9624QA01"
}

Checklist trước khi chạy thật

  • Endpoint chạy HTTPS

    Token và dữ liệu giao dịch luôn được mã hoá trên đường truyền.

  • Idempotent theo transaction_id

    Một giao dịch có thể được gửi lại — lưu ID đã xử lý để không cộng tiền hai lần.

  • Trả 200 nhanh, retry lo phần còn lại

    Phản hồi ngay rồi xử lý trong queue. Nếu lỗi, TinoPay tự gửi lại sau 5 phút.

  • Đối chiếu log

    Xem log từng lần gọi webhook trên dashboard và bấm gọi lại khi cần.

Xem toàn bộ tài liệu

Ứng dụng

Khớp với cách bạn đang thu tiền

Website TMĐT

Đơn hàng tự xác nhận

Khách chuyển khoản kèm mã đơn, TinoPay tách code và gọi webhook để đơn chuyển sang “Đã thanh toán”.

  • Webhook
  • Mã thanh toán

Hosting / SaaS

Thu tiền & gia hạn tự động

Mỗi hoá đơn một mã thanh toán; webhook kích hoạt hoặc gia hạn dịch vụ ngay khi tiền về, không chờ duyệt tay.

  • Webhook
  • REST API

Chuỗi cửa hàng

Mỗi chi nhánh một VA

Cấp VA riêng cho từng chi nhánh dưới cùng tài khoản BIDV, lọc webhook theo VA để biết tiền về điểm nào.

  • VA
  • Telegram / Lark

Kế toán

Đối soát qua Google Sheets

Mọi giao dịch tự ghi vào bảng tính; kế toán lọc, cộng tổng và đối chiếu mà không cần lập trình.

  • Google Sheets

Bảo mật

Kết nối chính thống, kiểm soát rõ ràng

Dữ liệu đi qua Open API do BIDV cung cấp cho doanh nghiệp — không đọc SMS, không đăng nhập hộ internet banking.

Không lưu mật khẩu ngân hàng

Kết nối qua Open API chính thức của BIDV, bạn không phải chia sẻ hay nhập mật khẩu internet banking cho TinoPay.

Token cho từng webhook

Mỗi request mang header ALLPAY-TOKEN hoặc Authorization: Apikey để endpoint xác minh đúng nguồn gửi.

HTTPS đầu cuối

Dashboard, REST API và webhook tới URL HTTPS của bạn đều được mã hoá trên đường truyền.

Log truy vết

Từng lần gọi webhook đều được ghi lại cùng phản hồi của server, giúp truy vết và gọi lại khi cần.

FAQ

Câu hỏi thường gặp

Chưa thấy câu trả lời? Xem tài liệu hướng dẫn.

TinoPay có cần mật khẩu ngân hàng của tôi không?

Không. TinoPay kết nối qua Open API chính thức của BIDV dành cho doanh nghiệp, nên bạn không phải chia sẻ hay nhập mật khẩu internet banking.

TinoPay hỗ trợ những ngân hàng nào?

Hiện TinoPay kết nối trực tiếp với BIDV (tài khoản doanh nghiệp). Ngân hàng mới sẽ được cập nhật tại trang này khi chính thức hỗ trợ.

Nếu endpoint webhook của tôi bị lỗi thì sao?

TinoPay tự gửi lại sau 5 phút. Bạn xem được log từng lần gọi và bấm gọi lại thủ công trên dashboard. Nên xử lý idempotent theo transaction_id để tránh ghi nhận trùng.

Tài khoản định danh (VA) là gì?

VA là số tài khoản phụ tạo dưới tài khoản BIDV của bạn. Tiền chuyển vào VA vẫn về tài khoản chính, nhưng mỗi giao dịch có trường virtualAccount để biết thuộc đơn hàng, cửa hàng hay khách nào.

TinoPay có REST API không?

Có. Bạn tra cứu lịch sử giao dịch (lọc theo ngày, loại, từ khoá, phân trang), lấy danh sách ngân hàng và tạo ảnh QR VietQR. Xem API giao dịch và API VietQR.

Đăng ký TinoPay như thế nào?

Đăng nhập bằng tài khoản Tino, chọn gói và quản lý dịch vụ ngay trong trang khách hàng Tino. Sau đó liên kết tài khoản BIDV, tạo VA và cấu hình webhook trên dashboard TinoPay.

Tiền về là hệ thống biết. Đối soát tự chạy.

Đăng nhập bằng tài khoản Tino, liên kết BIDV và nhận webhook giao dịch đầu tiên chỉ sau vài bước cấu hình.