Khách hàng đã chuyển khoản nhưng website vẫn chờ xác nhận? Nhân viên phải mở ứng dụng ngân hàng, tìm giao dịch rồi cập nhật đơn hàng thủ công?
API BIDV qua Pay2S giúp đưa thông tin giao dịch thanh toán vào website, phần mềm bán hàng hoặc hệ thống quản lý. Với luồng BIDV OpenAPI, khách hàng kết nối tài khoản và sử dụng tài khoản định danh VA để nhận tiền, theo dõi giao dịch và triển khai đối chiếu thanh toán tự động.
Bài viết hướng dẫn cách kết nối BIDV với Pay2S, lựa chọn giữa Webhook, API lịch sử giao dịch và Collection Link theo nhu cầu sử dụng.
API BIDV qua Pay2S là gì?
BIDV OpenAPI là phương thức kết nối với dịch vụ ngân hàng thông qua API. Pay2S cung cấp luồng kết nối BIDV và các công cụ tích hợp để phần mềm của khách hàng sử dụng dữ liệu thanh toán.
Trong mô hình này, website hoặc ứng dụng của bạn tích hợp với API Pay2S. Pay2S tiếp nhận dữ liệu từ kết nối ngân hàng và cung cấp thông tin qua Webhook hoặc API tra cứu.
Pay2S do Công ty Cổ phần FUTE phát triển. Thông tin hợp tác giữa BIDV và FUTE được công bố tại phần ngân hàng trên trang Open API Banking của Pay2S.
Thông tin ngân hàng BIDV
| Thông tin | Nội dung |
|---|---|
| Tên ngân hàng | Ngân hàng TMCP Đầu tư và Phát triển Việt Nam |
| Tên tiếng Anh | Joint Stock Commercial Bank for Investment and Development of Vietnam |
| Tên viết tắt | BIDV |
| Mã ngân hàng dùng trong Collection Link | BIDV |
| Mã BIN | 970418 |
| SWIFT Code | BIDVVNVX |
| Website | bidv.com.vn |
Tải logo BIDV Vector, AI, SVG, EPS, PNG
Khi thiết kế giao diện chọn ngân hàng, trang thanh toán hoặc tài liệu hướng dẫn tích hợp, bạn có thể tham khảo bộ logo tại bài viết Tải logo BIDV file Vector, AI, SVG, EPS, PNG.
BIDV OpenAPI trên Pay2S hoạt động như thế nào?
Luồng BIDV OpenAPI trên Pay2S sử dụng tài khoản định danh, còn gọi là tài khoản ảo VA, để nhận diện các khoản tiền chuyển đến.
Sau khi liên kết thành công, bạn sử dụng đúng số VA được hiển thị trên Pay2S để nhận thanh toán. Giao dịch qua VA được đưa vào hệ thống, phục vụ theo dõi và xử lý theo cấu hình tích hợp.
Điểm cần lưu ý: với luồng này, khách hàng cần chuyển tiền vào VA đã liên kết để Pay2S nhận dữ liệu. Không nên hiểu rằng hệ thống sẽ tự đồng bộ toàn bộ giao dịch tiền vào, tiền ra của tài khoản ngân hàng gốc.
Khi triển khai bằng API, hãy lấy số VA từ kết quả liên kết thành công. Tham khảo cấu trúc dữ liệu tại tài liệu quản lý tài khoản ngân hàng.
Kết nối API BIDV giúp ích gì cho việc bán hàng?
Giảm thao tác kiểm tra chuyển khoản
Khi nhận được dữ liệu giao dịch, phần mềm có thể kiểm tra số tiền, tài khoản nhận và thông tin tham chiếu để xác định khoản thanh toán tương ứng.
Nhân viên giảm thời gian tìm giao dịch hoặc đối chiếu ảnh chuyển khoản do người mua gửi.
Kết nối thanh toán với đơn hàng
Website có thể sử dụng Collection Link để tạo yêu cầu thanh toán cho từng đơn. Sau khi tiếp nhận và xác minh kết quả, hệ thống cập nhật trạng thái đơn để tiếp tục giao hàng hoặc cung cấp dịch vụ.
Hỗ trợ tra cứu và đối soát
API lịch sử giao dịch giúp phần mềm chủ động lấy dữ liệu đã được Pay2S ghi nhận theo khoảng thời gian. Đây là công cụ hỗ trợ kiểm tra các đơn chưa khớp hoặc đối chiếu báo cáo bán hàng.
Bạn có thể tìm hiểu các hướng triển khai tại giải pháp Open API Banking của Pay2S.
Hướng dẫn kết nối tài khoản BIDV với Pay2S
Luồng liên kết BIDV hiện có lựa chọn dành cho cá nhân và hộ kinh doanh. Người dùng chọn đúng loại tài khoản và cung cấp thông tin tương ứng khi đăng ký kết nối.
Bước 1: Đăng nhập và chọn ngân hàng BIDV
Đăng nhập Pay2S, mở phần quản lý ngân hàng, chọn thêm tài khoản và chọn BIDV OpenAPI.
Bước 2: Nhập thông tin liên kết
Chuẩn bị số tài khoản BIDV, tên chủ tài khoản hoặc tên hộ kinh doanh, số điện thoại, email và thông tin định danh theo biểu mẫu.
Biểu mẫu cá nhân sử dụng CCCD; biểu mẫu hộ kinh doanh sử dụng mã số thuế. Bạn cũng thiết lập phần hậu tố tài khoản định danh theo hướng dẫn trên màn hình.
Bước 3: Hoàn tất xác thực
Kiểm tra thông tin, chấp thuận điều khoản và nhập OTP khi hệ thống yêu cầu. Quy trình liên kết BIDV OpenAPI này không yêu cầu nhập mật khẩu Internet Banking.
Bước 4: Kiểm tra VA và thử nhận thanh toán
Sau khi liên kết thành công, kiểm tra trạng thái kết nối và số VA hiển thị. Thực hiện một giao dịch thử vào đúng VA để kiểm tra dữ liệu trước khi đưa vào quy trình bán hàng.
Thông tin về loại tài khoản và dữ liệu liên kết được mô tả thêm trong tài liệu kết nối ngân hàng Pay2S.
Nên dùng Webhook, API lịch sử hay Collection Link?
| Nhu cầu | Cách tích hợp phù hợp |
|---|---|
| Nhận thông tin khi có giao dịch mới | Webhook giao dịch |
| Chủ động tìm giao dịch theo thời gian | API lịch sử giao dịch |
| Tạo yêu cầu thanh toán cho từng đơn hàng | Collection Link |
| Kiểm tra các giao dịch chưa khớp | Kết hợp Webhook và API lịch sử |
Webhook giao dịch cung cấp thông tin khoản tiền đã được ghi nhận. Collection Link tổ chức luồng thanh toán theo đơn và có thông báo kết quả riêng qua IPN.
Vì vậy, cần chọn đúng tài liệu và cơ chế xác thực cho từng luồng tích hợp.
Nhận Webhook giao dịch BIDV
Webhook cho phép Pay2S chủ động gửi dữ liệu đến địa chỉ nhận của website hoặc phần mềm. Bạn không phải liên tục gọi API chỉ để kiểm tra có giao dịch mới hay chưa.
Các bước triển khai:
- Tạo endpoint HTTPS nhận dữ liệu trên máy chủ của bạn.
- Khai báo Webhook và chọn tài khoản nhận thông báo trên Pay2S.
- Cấu hình token xác thực.
- Kiểm tra dữ liệu giao dịch và lưu kết quả.
- Chống xử lý trùng trước khi cập nhật đơn hàng.
Với Webhook người dùng, Pay2S gửi token trong header:
Authorization: Bearer <TOKEN_WEBHOOK>
Sau khi đã lưu giao dịch hoặc đưa vào hàng đợi bền vững, endpoint phản hồi HTTP 200 cùng JSON:
{
"success": true
}
Trường checksum hỗ trợ nhận diện giao dịch; không dùng trường này thay cho xác thực nguồn gửi. Xem cấu trúc payload và cách phản hồi tại tài liệu kỹ thuật Webhook Pay2S.
Tra cứu lịch sử giao dịch BIDV bằng API
API lịch sử dùng để lấy dữ liệu giao dịch đã được Pay2S ghi nhận. Endpoint:
POST https://api.pay2s.vn/userapi/transactions
Ví dụ cURL dưới đây dùng cú pháp Bash. Thay token và số tài khoản bằng thông tin thực tế:
curl --request POST \
'https://api.pay2s.vn/userapi/transactions' \
--header 'Content-Type: application/json' \
--header 'pay2s-token: TOKEN_BASE64_CUA_BAN' \
--data '{
"bankAccounts": "SO_TAI_KHOAN_DA_LIEN_KET",
"begin": "01/11/2026",
"end": "12/11/2026"
}'
Trong đó:
| Tham số | Ý nghĩa |
|---|---|
pay2s-token |
Giá trị Base64 của Secret Key, chuyển đổi một lần |
bankAccounts |
Số tài khoản cần lọc giao dịch |
begin |
Ngày bắt đầu, định dạng dd/MM/yyyy |
end |
Ngày kết thúc, định dạng dd/MM/yyyy |
Secret Key được lấy tại Tích hợp → Website/Application. Base64 là cách biểu diễn dữ liệu có thể giải mã ngược, nên token phải được giữ kín tại backend.
Tham khảo phản hồi và giới hạn truy cập tại tài liệu API lịch sử giao dịch.
Tạo liên kết thanh toán BIDV bằng Collection Link
Collection Link phù hợp khi website cần tạo một yêu cầu thanh toán gắn với mã đơn, số tiền và địa chỉ nhận kết quả.
Endpoint tạo đơn:
POST https://payment.pay2s.vn/v1/gateway/api/create
Trong request, bankAccounts là mảng tài khoản nhận tiền. Ví dụ riêng phần cấu hình BIDV:
{
"bankAccounts": [
{
"account_number": "SO_TAI_KHOAN_BIDV_DA_LIEN_KET",
"bank_id": "BIDV"
}
]
}
Đây chỉ là một phần của request. Bạn cần gửi thêm các trường bắt buộc và tạo chữ ký theo đúng phiên bản tích hợp.
ipnUrl là endpoint backend nhận kết quả thanh toán. redirectUrl là địa chỉ đưa người mua trở lại website. Việc trình duyệt chuyển về redirectUrl chưa đủ để xác nhận đơn đã thanh toán.
Xem request đầy đủ tại tài liệu Collection Link.
Nếu cần gửi thêm thông tin người mua và hàng hóa phục vụ hóa đơn điện tử, tham khảo Collection Link V2. V2 vẫn sử dụng endpoint tạo đơn trên; việc lập hoặc phát hành hóa đơn phụ thuộc dữ liệu gửi lên và cấu hình hóa đơn của tài khoản.
Câu hỏi thường gặp về API BIDV qua Pay2S
Chuyển vào tài khoản BIDV gốc có được ghi nhận như chuyển vào VA không?
Với luồng BIDV OpenAPI sử dụng tài khoản định danh trên Pay2S, cần chuyển vào đúng VA đã liên kết để hệ thống nhận dữ liệu. Khi tạo hướng dẫn thanh toán hoặc QR, hãy sử dụng thông tin do Pay2S cung cấp.
Có cần nhập mật khẩu ngân hàng để kết nối không?
Biểu mẫu BIDV OpenAPI hiện không yêu cầu mật khẩu Internet Banking. Bạn cung cấp thông tin liên kết và hoàn tất xác thực OTP khi được yêu cầu.
Có thể dùng API để lấy toàn bộ sao kê cũ không?
API lịch sử trả dữ liệu đã có trên Pay2S trong phạm vi lưu trữ và quyền truy cập của tài khoản. API này không thay thế dịch vụ lấy toàn bộ sao kê của ngân hàng.
Nhận Webhook có nghĩa là đơn hàng đã thanh toán đủ không?
Phần mềm cần kiểm tra tài khoản nhận, số tiền và thông tin tham chiếu trước khi cập nhật đơn. Một giao dịch tiền vào chưa chắc đã khớp với đơn đang chờ.
Chi phí sử dụng được tính thế nào?
Bạn nên chọn gói theo số tài khoản cần kết nối, lượng giao dịch và tính năng sử dụng. Xem quyền lợi, hạn mức và điều kiện tại bảng giá Pay2S.
Bắt đầu tích hợp BIDV với Pay2S
Kết nối tài khoản BIDV, kiểm tra VA nhận tiền và chọn luồng tích hợp phù hợp: Webhook để nhận giao dịch, API để tra cứu hoặc Collection Link để quản lý thanh toán theo đơn.
Bắt đầu với Pay2S hoặc xem tài liệu dành cho lập trình viên để triển khai.




