API Vietcombank là gì? Hướng dẫn kết nối và tích hợp qua Pay2S

Bởi Pay2S 9 phút đọc

Khi nhận thanh toán qua Vietcombank, việc kiểm tra từng giao dịch và cập nhật đơn hàng thủ công có thể làm chậm quá trình bán hàng. Website cần biết khách đã thanh toán chưa; nhân viên cần tìm đúng giao dịch; kế toán cần dữ liệu để đối chiếu.

API Vietcombank qua Pay2S giúp kết nối dữ liệu thanh toán với website, phần mềm bán hàng và hệ thống quản lý. Bạn có thể nhận thông báo giao dịch qua Webhook, chủ động tra cứu lịch sử hoặc tạo yêu cầu thanh toán theo từng đơn hàng.

Trước khi triển khai, cần chọn đúng phương thức kết nối: Vietcombank OpenAPI và Pay2S API có cách đăng ký, phạm vi dữ liệu và điều kiện sử dụng khác nhau.

API Vietcombank qua Pay2S là gì?

API Vietcombank qua Pay2S là cách để website hoặc phần mềm sử dụng dữ liệu giao dịch từ tài khoản Vietcombank đã kết nối với Pay2S.

Phần mềm của bạn gọi API hoặc tiếp nhận thông báo từ Pay2S, sau đó sử dụng dữ liệu để đối chiếu thanh toán, cập nhật đơn hàng hoặc tổng hợp báo cáo.

Pay2S do Công ty Cổ phần FUTE phát triển. Công văn hợp tác giữa Vietcombank 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 Vietcombank

Thông tin Nội dung
Tên ngân hàng Ngân hàng TMCP Ngoại thương Việt Nam
Tên tiếng Anh Joint Stock Commercial Bank for Foreign Trade of Vietnam
Tên thường gọi Vietcombank
Mã ngân hàng dùng trong Collection Link VCB
Mã BIN 970436
SWIFT Code BFTVVNVX
Website vietcombank.com.vn

Tải logo Vietcombank 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 Vietcombank file Vector, AI, SVG, EPS, PNG.

Phân biệt Vietcombank OpenAPI và Pay2S API

Trên Pay2S, Vietcombank có các lựa chọn kết nối phục vụ những nhu cầu khác nhau.

Tiêu chí Vietcombank OpenAPI Pay2S API
Phương thức Kết nối dịch vụ theo luồng OpenAPI của ngân hàng Tự động truy xuất dữ liệu Internet Banking bằng RPA theo ủy quyền
Đăng ký Gửi thông tin merchant và hoàn tất thủ tục ngân hàng Liên kết bằng thông tin đăng nhập ngân hàng theo biểu mẫu
Mật khẩu Internet Banking Biểu mẫu đăng ký OpenAPI không yêu cầu Cần cho luồng kết nối RPA
Phạm vi sử dụng Nhận dữ liệu thanh toán qua QR/VA được kích hoạt Truy xuất dữ liệu trong phạm vi tài khoản và kết nối được hỗ trợ
Điều kiện hoạt động Được ngân hàng phê duyệt, kích hoạt dịch vụ Kết nối đăng nhập còn hiệu lực

Vietcombank OpenAPI

Luồng đăng ký OpenAPI trên Pay2S dành cho nhóm hộ kinh doanh/doanh nghiệp, theo điều kiện tiếp nhận của ngân hàng.

Khách hàng gửi thông tin đăng ký và hoàn tất thủ tục hợp đồng. Sau khi dịch vụ được phê duyệt, khách hàng sử dụng QR hoặc tài khoản định danh được cấp để nhận dữ liệu thanh toán.

Với luồng này, cần sử dụng đúng QR/VA của kết nối đã kích hoạt. Không mặc định rằng mọi khoản tiền chuyển trực tiếp vào tài khoản gốc hoặc mọi giao dịch chi tiền đều được đồng bộ.

Pay2S API qua Internet Banking

Pay2S API sử dụng công nghệ tự động hóa RPA để truy xuất dữ liệu tài khoản ngân hàng theo phạm vi khách hàng cho phép.

Phương thức này cần thông tin đăng nhập và có thể yêu cầu xác thực bổ sung theo luồng ngân hàng. Đây là lựa chọn riêng với kết nối OpenAPI. Các mẫu tích hợp RPA được mô tả trong tài liệu quản lý tài khoản ngân hàng Pay2S.

API Vietcombank có thể hỗ trợ những công việc nào?

Xác nhận thanh toán cho website

Website có thể đối chiếu dữ liệu nhận được với số tiền, mã đơn và tài khoản nhận để cập nhật trạng thái thanh toán.

Ví dụ, khi khách thanh toán một đơn hàng, hệ thống tiếp nhận kết quả, kiểm tra điều kiện khớp và chuyển đơn sang bước xử lý tiếp theo.

Đưa dữ liệu giao dịch vào phần mềm bán hàng

Phần mềm có thể sử dụng Webhook để tiếp nhận thông tin giao dịch, phục vụ việc xác nhận tại quầy hoặc đối chiếu với phiên bán hàng.

Hỗ trợ kế toán và đối soát

API lịch sử giúp chủ động tìm giao dịch đã được ghi nhận trên Pay2S, kiểm tra đơn chưa khớp và tổng hợp dữ liệu theo khoảng thời gian.

Phạm vi dữ liệu thực tế phụ thuộc phương thức kết nối Vietcombank đang sử dụng.

Hướng dẫn kết nối Vietcombank với Pay2S

Bước 1: Chọn phương thức kết nối

Đăng nhập Pay2S, mở phần thêm tài khoản ngân hàng và chọn Vietcombank.

Chọn loại tài khoản và phương thức kết nối phù hợp với nhu cầu. Nếu sử dụng OpenAPI, cần thực hiện theo luồng đăng ký merchant đang được hỗ trợ.

Bước 2: Cung cấp thông tin tương ứng

Với OpenAPI, chuẩn bị số tài khoản, tên đơn vị hoặc chủ tài khoản, email, số điện thoại và mã số thuế theo biểu mẫu. Pay2S tiếp nhận thông tin để hỗ trợ thủ tục hợp đồng và kích hoạt.

Với Pay2S API, nhập thông tin kết nối Internet Banking theo hướng dẫn trên màn hình.

Bước 3: Hoàn tất đăng ký hoặc xác thực

Đối với OpenAPI, việc gửi biểu mẫu chưa đồng nghĩa dịch vụ đã hoạt động. Cần hoàn tất thủ tục và nhận kết quả kích hoạt.

Đối với Pay2S API, hoàn tất các bước xác thực được yêu cầu và kiểm tra trạng thái kết nối.

Bước 4: Kiểm thử trước khi tích hợp chính thức

Thực hiện một giao dịch thử theo đúng phương thức nhận tiền của kết nối. Kiểm tra giao dịch trên Pay2S, dữ liệu Webhook và kết quả xử lý tại phần mềm của bạn.

Chọn API Vietcombank theo nhu cầu tích hợp

Nhu cầu Công cụ phù hợp
Nhận dữ liệu khi có giao dịch mới Webhook giao dịch
Tìm giao dịch theo khoảng thời gian API lịch sử giao dịch
Tạo trang thanh toán cho từng đơn Collection Link
Tạo và quản lý QR động theo đơn OneQR với kết nối đủ điều kiện

Các công cụ có thể kết hợp trong cùng hệ thống. Chẳng hạn, website dùng Webhook để tiếp nhận giao dịch và API lịch sử để kiểm tra lại khi cần đối soát.

Tra cứu lịch sử giao dịch Vietcombank bằng API

API lịch sử trả dữ liệu giao dịch đã được Pay2S ghi nhận:

POST https://api.pay2s.vn/userapi/transactions

Ví dụ cURL dùng cú pháp Bash:

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_VCB_DA_LIEN_KET",
    "begin": "01/11/2026",
    "end": "12/11/2026"
  }'

Thay token và số tài khoản mẫu bằng thông tin thực tế.

Tham số Ý nghĩa
pay2s-token Base64 của nguyên chuỗi Secret Key, chuyển đổi một lần
bankAccounts Số tài khoản cần lọc dữ liệu
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. Giữ kín cả Secret Key và token tại backend vì Base64 có thể giải mã ngược.

Xem cấu trúc phản hồi và giới hạn sử dụng tại tài liệu API lịch sử giao dịch.

Nhận Webhook giao dịch Vietcombank

Webhook giúp Pay2S chủ động gửi dữ liệu đến endpoint của bạn khi hệ thống ghi nhận giao dịch thuộc cấu hình nhận thông báo.

Quy trình tích hợp:

  1. Tạo endpoint HTTPS nhận dữ liệu.
  2. Khai báo Webhook và tài khoản cần theo dõi trên Pay2S.
  3. Cấu hình token xác thực.
  4. Kiểm tra dữ liệu và chống xử lý trùng.
  5. Lưu giao dịch, sau đó cập nhật nghiệp vụ phù hợp.

Webhook người dùng gửi token qua header:

Authorization: Bearer <TOKEN_WEBHOOK>

Sau khi đã lưu dữ liệu hoặc đưa vào hàng đợi bền vững, endpoint trả HTTP 200 và:

{
  "success": true
}

Webhook có thể được gửi lại, nên một giao dịch không được cộng tiền hoặc xác nhận đơn nhiều lần. checksum hỗ trợ nhận diện giao dịch, không thay thế token xác thực. Tham khảo tài liệu kỹ thuật Webhook Pay2S.

Tạo liên kết thanh toán Vietcombank bằng Collection Link

Collection Link giúp website tạo yêu cầu thanh toán gắn với mã đơn và số tiền cần thu.

Endpoint:

POST https://payment.pay2s.vn/v1/gateway/api/create

Phần lựa chọn tài khoản Vietcombank trong request có dạng:

{
  "bankAccounts": [
    {
      "account_number": "SO_TAI_KHOAN_VCB_DA_LIEN_KET",
      "bank_id": "VCB"
    }
  ]
}

Đây là một phần của request. Cần bổ sung các trường bắt buộc và tạo chữ ký theo đúng phiên bản tài liệu.

Khi nhận được liên kết thanh toán, website hiển thị hoặc chuyển người mua đến trang thanh toán. Backend tiếp nhận IPN tại ipnUrl, xác minh chữ ký và đối chiếu thông tin đơn trước khi cập nhật kết quả.

redirectUrl phục vụ chuyển hướng người mua. Không xác nhận thanh toán chỉ dựa vào việc trình duyệt quay lại website.

Xem hướng dẫn đầy đủ tại tài liệu Collection Link.

Tạo QR động Vietcombank với OneQR

Với kết nối đủ điều kiện, OneQR hỗ trợ tạo QR theo từng đơn, kèm số tiền và nội dung thanh toán. Luồng tạo QR sử dụng các thông tin kết nối như Merchant ID và Terminal ID.

Phần mềm cần lưu các mã định danh từ phản hồi để tra cứu, đối soát hoặc thực hiện thao tác tiếp theo. Việc tạo QR thành công mới là bước chuẩn bị thanh toán; kết quả nhận tiền cần được kiểm tra riêng.

Tham khảo API tạo OneQR và API kiểm tra trạng thái OneQR.

Câu hỏi thường gặp về API Vietcombank

Có phải mọi kết nối Vietcombank trên Pay2S đều là OpenAPI?

Không. Pay2S có lựa chọn OpenAPI theo luồng đăng ký merchant và lựa chọn Pay2S API sử dụng RPA. Cần xác định đúng phương thức khi đăng ký và triển khai.

Kết nối Vietcombank có cần mật khẩu Internet Banking không?

Biểu mẫu đăng ký OpenAPI không yêu cầu mật khẩu Internet Banking. Luồng Pay2S API qua RPA cần thông tin đăng nhập để thực hiện kết nối theo ủy quyền.

Webhook có thay thế việc kiểm tra đơn hàng không?

Webhook cung cấp dữ liệu giao dịch. Phần mềm vẫn phải kiểm tra số tiền, tài khoản nhận, thông tin tham chiếu và tình trạng xử lý trước đó để xác nhận đúng đơn.

API có lấy được toàn bộ sao kê Vietcombank 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. Dữ liệu còn phụ thuộc phương thức kết nối; không mặc định bao gồm toàn bộ sao kê ngân hàng.

Chi phí sử dụng API Vietcombank được tính thế nào?

Bạn nên chọn gói theo số tài khoản, lượng giao dịch và chức năng cần sử dụng. Kiểm tra quyền lợi tại bảng giá Pay2S và điều kiện riêng của phương thức kết nối trước khi triển khai.

Bắt đầu kết nối Vietcombank với Pay2S

Chọn phương thức kết nối phù hợp, hoàn tất kích hoạt và kiểm thử dữ liệu thực tế. Sau đó, tích hợp Webhook, API lịch sử hoặc Collection Link để đưa thanh toán Vietcombank vào quy trình vận hành của bạn.

Bắt đầu với Pay2S hoặc xem tài liệu dành cho lập trình viên.

    Chia sẻ bài viết