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

Bởi Pay2S 11 phút đọc

Khách đã chuyển khoản vào tài khoản ACB 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 từng đơn hàng? Đây là những thao tác có thể tự động hóa khi kết nối dữ liệu ngân hàng với hệ thống bán hàng.

Tích hợp API ACB qua Pay2S giúp website và phần mềm nhận thông tin giao dịch, tra cứu lịch sử và đưa kết quả thanh toán vào quy trình xử lý đơn. Tùy nhu cầu, bạn có thể sử dụng Webhook giao dịch, API tra cứu hoặc Collection Link để tạo liên kết thanh toán.

Bài viết này hướng dẫn cách lựa chọn và triển khai từng luồng, dành cho chủ website, doanh nghiệp và đội ngũ kỹ thuật đang sử dụng tài khoản ACB.

API ACB qua Pay2S là gì?

API là giao diện giúp các phần mềm trao đổi dữ liệu với nhau. Với nhu cầu nhận thanh toán ACB, Pay2S hỗ trợ kết nối tài khoản ngân hàng và cung cấp dữ liệu giao dịch cho hệ thống của khách hàng thông qua API hoặc Webhook.

Pay2S có luồng liên kết ACB OpenAPI cho tài khoản cá nhân và doanh nghiệp, kèm bước xác thực theo loại tài khoản. Sau khi liên kết thành công, bạn có thể triển khai các chức năng phù hợp với quyền sử dụng của tài khoản. Xem tài liệu kết nối ngân hàng ACB.

Luồng dữ liệu có thể hình dung như sau:

Tài khoản ACB → Pay2S ghi nhận giao dịch → Website hoặc phần mềm tiếp nhận và xử lý.

Khi tích hợp theo bài viết này, website gọi các endpoint do Pay2S cung cấp. Bộ khóa tích hợp, cấu trúc dữ liệu và cách xác thực cần thực hiện theo tài liệu Pay2S tương ứng.

Tải logo ACB Vector, AI, SVG, EPS, PNG

Khi thiết kế giao diện lựa chọn ngân hàng, trang thanh toán hoặc tài liệu tích hợp API ACB, bạn có thể tham khảo và tải bộ logo tại bài viết tải logo ACB.

Có thể làm gì khi kết nối ACB với Pay2S?

Tự động ghi nhận thanh toán

Website có thể tiếp nhận giao dịch tiền vào, đối chiếu với đơn hàng và cập nhật trạng thái khi đủ điều kiện.

Ví dụ, đơn hàng cần thanh toán 250.000 đồng. Sau khi nhận được giao dịch ACB, hệ thống kiểm tra tài khoản nhận, số tiền và mã thanh toán trước khi xác nhận đơn đã thanh toán.

Việc đối chiếu giúp giảm thao tác kiểm tra ảnh chuyển khoản và hạn chế xác nhận nhầm đơn.

Tra cứu và đối soát giao dịch

Phần mềm có thể lấy danh sách giao dịch Pay2S đã ghi nhận theo số tài khoản và khoảng thời gian. Dữ liệu này phục vụ kiểm tra thanh toán, đối chiếu với đơn hàng hoặc rà soát những giao dịch chưa xử lý.

Kết nối website, POS và hệ thống quản lý

Dữ liệu giao dịch ACB có thể được đưa vào website bán hàng, phần mềm POS, ERP hoặc hệ thống nội bộ có khả năng tích hợp API.

Chẳng hạn, phần mềm bán hàng có thể dùng giao dịch để xác nhận một phiếu thu; hệ thống quản lý công nợ có thể đối chiếu khoản thanh toán với khách hàng tương ứng. Quy tắc ghép dữ liệu được triển khai theo nhu cầu của từng doanh nghiệp.

Nên dùng API lịch sử, Webhook hay Collection Link?

Ba hình thức này phục vụ những nhu cầu khác nhau:

Nhu cầu Hình thức phù hợp
Nhận thông tin giao dịch mới của tài khoản ACB Webhook giao dịch
Tìm và kiểm tra lại giao dịch đã được Pay2S ghi nhận API lịch sử giao dịch
Tạo đơn và trang thanh toán cho website Collection Link
Nhận kết quả thanh toán của đơn Collection Link IPN thanh toán
Đối soát và xử lý giao dịch bị bỏ sót tại phần mềm nhận Kết hợp Webhook với API lịch sử

Webhook giao dịch và IPN thanh toán có cấu trúc, cách xác thực và quy trình xử lý riêng. Đội kỹ thuật cần chọn đúng tài liệu cho từng luồng. Tìm hiểu các phương thức tích hợp Pay2S.

Hướng dẫn kết nối tài khoản ACB với Pay2S

Bước 1: Tạo tài khoản Pay2S

Truy cập Pay2S để đăng ký hoặc đăng nhập. Kiểm tra gói dịch vụ và quyền sử dụng các tính năng cần triển khai trước khi tích hợp.

Bước 2: Liên kết tài khoản ACB

Trong phần quản lý ngân hàng, chọn thêm tài khoản ACB và phương thức OpenAPI phù hợp.

Nhập thông tin được yêu cầu, hoàn tất bước xác thực theo hướng dẫn trên màn hình và kiểm tra trạng thái liên kết. Tài khoản cá nhân và doanh nghiệp có thể yêu cầu thông tin đăng ký khác nhau.

Chỉ bắt đầu thử giao dịch sau khi tài khoản đã liên kết thành công và đang hoạt động.

Bước 3: Chọn luồng tích hợp

  • Nếu phần mềm đã có quy trình tạo đơn và cần nhận giao dịch ngân hàng, cấu hình Webhook.
  • Nếu cần chủ động tìm kiếm hoặc đối soát dữ liệu, sử dụng API lịch sử giao dịch.
  • Nếu muốn website tạo liên kết thanh toán qua Pay2S, triển khai Collection Link và endpoint nhận IPN.

Bước 4: Kiểm thử trước khi vận hành

Thực hiện một giao dịch thử với số tiền và nội dung dễ nhận diện. Kiểm tra dữ liệu tại Pay2S, kết quả gửi về phần mềm và trạng thái đơn hàng.

Ngoài trường hợp thanh toán đúng, nên thử các tình huống thiếu tiền, sai nội dung, thông báo gửi lại và endpoint tạm thời không hoạt động.

Nhận Webhook giao dịch ACB

Webhook giúp phần mềm nhận thông báo khi Pay2S ghi nhận giao dịch phù hợp với cấu hình đã đăng ký. Hệ thống của bạn cần chuẩn bị một endpoint HTTPS để tiếp nhận HTTP POST.

Luồng xử lý:

Giao dịch phát sinh → Pay2S ghi nhận → Gửi Webhook → Phần mềm xác thực và đối chiếu → Cập nhật kết quả.

Ví dụ dữ liệu nhận được

Dưới đây là dữ liệu minh họa, không phải giao dịch thật:

{
  "transactions": [
    {
      "id": 10001,
      "gateway": "ACB",
      "transactionDate": "2026-11-12 10:30:00",
      "transactionNumber": "DEMO10001",
      "accountNumber": "YOUR_ACB_ACCOUNT_NUMBER",
      "content": "THANHTOAN DH10001",
      "transferType": "IN",
      "transferAmount": 250000,
      "checksum": "DEMO_TRANSACTION_CHECKSUM"
    }
  ]
}

Các trường thường dùng để xử lý gồm:

Trường Ý nghĩa
id ID giao dịch trên Pay2S
gateway Ngân hàng, trong ví dụ là ACB
transactionDate Thời gian giao dịch
transactionNumber Mã giao dịch từ nguồn ngân hàng
accountNumber Tài khoản gắn với giao dịch
content Nội dung chuyển khoản
transferType Chiều giao dịch: tiền vào IN hoặc tiền ra OUT
transferAmount Số tiền giao dịch
checksum Mã nhận diện giao dịch do Pay2S cung cấp

checksum không thay thế bước xác thực nguồn gửi. Endpoint cần kiểm tra token trong header Authorization theo cấu hình Webhook. Xem hướng dẫn tạo và xác thực Webhook.

Tiếp nhận và phản hồi Webhook

Một quy trình tiếp nhận phù hợp gồm:

  1. Kiểm tra thông tin xác thực và dữ liệu đầu vào.
  2. Kiểm tra giao dịch đã được xử lý hay chưa.
  3. Lưu giao dịch hoặc đưa vào hàng đợi bền vững.
  4. Trả HTTP 200 với JSON:
{
  "success": true
}

Các tác vụ như gửi email, tạo báo cáo hoặc xử lý nghiệp vụ dài có thể thực hiện sau bước tiếp nhận.

Cần chống xử lý trùng vì cùng một giao dịch có thể được gửi lại. Nếu dữ liệu chưa được lưu thành công, không nên phản hồi đã tiếp nhận. Xem tài liệu kỹ thuật Webhook.

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

API lịch sử phù hợp khi bạn cần kiểm tra lại dữ liệu hoặc đồng bộ các giao dịch mà phần mềm chưa tiếp nhận.

Endpoint:

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

Yêu cầu sử dụng Content-Type: application/json và header pay2s-token, được tạo bằng cách chuyển Secret Key sang Base64. Secret Key nằm tại mục Tích hợp → Website/Application.

Ví dụ cURL:

curl --request POST \
  'https://api.pay2s.vn/userapi/transactions' \
  --header 'Content-Type: application/json' \
  --header "pay2s-token: ${PAY2S_TOKEN}" \
  --data '{
    "bankAccounts": "YOUR_ACB_ACCOUNT_NUMBER",
    "begin": "01/11/2026",
    "end": "12/11/2026"
  }'

Thay YOUR_ACB_ACCOUNT_NUMBER bằng số tài khoản đã liên kết và thiết lập PAY2S_TOKEN tại máy chủ.

  • bankAccounts: số tài khoản cần tra cứu.
  • begin: ngày bắt đầu, định dạng dd/MM/yyyy.
  • end: ngày kết thúc, cùng định dạng.

Tham khảo đầy đủ tham số, cấu trúc 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.

API trả dữ liệu Pay2S đã ghi nhận trong phạm vi lưu trữ của hệ thống. Không nên hiểu việc liên kết tài khoản là tự động truy xuất được toàn bộ sao kê ACB từ trước đó.

Base64 chỉ là cách biểu diễn dữ liệu, không bảo vệ Secret Key. Token cần được lưu tại backend và truyền qua HTTPS.

Tạo thanh toán ACB bằng Collection Link

Collection Link phù hợp khi website muốn tạo yêu cầu thanh toán gắn với từng đơn hàng.

Luồng triển khai:

Tạo đơn → Gọi Collection Link → Nhận liên kết thanh toán → Khách chuyển khoản → Nhận và xác minh IPN → Cập nhật đơn.

Endpoint tạo đơn:

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

Trong bankAccounts, tài khoản ACB được khai báo theo cấu trúc:

[
  {
    "account_number": "YOUR_ACB_ACCOUNT_NUMBER",
    "bank_id": "ACB"
  }
]

Số tài khoản phải thuộc kết nối phù hợp trên Pay2S. Các trường còn lại, chữ ký và cách xử lý kết quả cần thực hiện theo tài liệu Collection Link.

Khi cần gửi thêm dữ liệu hóa đơn điện tử

Collection Link V2 hỗ trợ gửi thông tin người mua, hàng hóa và yêu cầu hóa đơn điện tử. V2 vẫn dùng endpoint tạo đơn trên, nhưng có signatureVersion: "2" và cách ký dữ liệu tương ứng.

Việc tạo đơn thanh toán không đồng nghĩa hóa đơn đã phát hành. Khách hàng cần cấu hình kết nối hóa đơn điện tử, mẫu và chế độ xử lý phù hợp. Xem Collection Link V2.

Phân biệt IPN và trang chuyển hướng

ipnUrl là địa chỉ backend nhận kết quả thanh toán. redirectUrl đưa người mua trở lại website.

Backend cần xác minh chữ ký IPN, đối chiếu mã đơn, số tiền và trạng thái trước khi ghi nhận thanh toán. Không đánh dấu đơn thành công chỉ vì khách mở được trang chuyển hướng. Xem hướng dẫn tích hợp và xác minh IPN bằng SDK.

Lưu ý để tích hợp thanh toán ACB ổn định

Đối chiếu đủ thông tin trước khi xác nhận đơn. Với luồng nhận giao dịch, cần kiểm tra tài khoản, chiều tiền vào, số tiền và mã thanh toán. Trường hợp không khớp nên được đưa vào danh sách cần kiểm tra.

Lưu trạng thái xử lý để chống trùng. Một thông báo gửi lại không được làm cộng tiền, giao hàng hoặc cấp dịch vụ thêm lần nữa.

Theo dõi các lỗi tích hợp. Lưu mã yêu cầu, mã giao dịch và kết quả xử lý để tìm được nguyên nhân khi một đơn chưa cập nhật.

Bảo vệ khóa tích hợp. Secret Key và token cần được quản lý tại backend. Không đưa các giá trị này vào JavaScript phía trình duyệt hoặc kho mã nguồn công khai.

Kết hợp thông báo với tra cứu. Dùng Webhook hoặc IPN cho luồng xử lý thường xuyên; dùng API lịch sử để kiểm tra và đối soát khi cần.

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

Pay2S có hỗ trợ tài khoản ACB cá nhân và doanh nghiệp không?

Có luồng kết nối ACB OpenAPI cho cả tài khoản cá nhân và doanh nghiệp. Thông tin đăng ký và bước xác thực cần thực hiện theo loại tài khoản được chọn.

Có cần gọi API liên tục để biết khách đã thanh toán không?

Với nhu cầu nhận giao dịch, bạn có thể sử dụng Webhook. Với đơn Collection Link, triển khai IPN để backend nhận kết quả thanh toán. API tra cứu dùng để kiểm tra lại hoặc đối soát khi cần.

Nhận được Webhook là có thể xác nhận đơn ngay không?

Hệ thống cần xác thực thông báo và đối chiếu giao dịch với đơn hàng trước. Giao dịch thiếu tiền, sai nội dung hoặc đã được sử dụng để thanh toán đơn khác cần có cách xử lý riêng.

Tạo mã QR có đồng nghĩa với việc theo dõi được thanh toán không?

Không. QR cung cấp thông tin để khách chuyển khoản. Để xác nhận đã nhận tiền, hệ thống cần kết nối dữ liệu giao dịch hoặc sử dụng luồng thanh toán có thông báo kết quả.

Có thể dùng API ACB qua Pay2S cho phần mềm tự viết không?

Có thể tích hợp với phần mềm có khả năng gửi HTTP request và tiếp nhận Webhook hoặc IPN. Đội kỹ thuật cần triển khai xác thực, đối chiếu dữ liệu và chống xử lý trùng theo tài liệu.

Chi phí tích hợp API ACB được tính như thế nào?

Bạn cần đối chiếu gói Pay2S đang sử dụng, số tài khoản ngân hàng cần kết nối và các tính năng muốn triển khai. Xem bảng giá hiện hành trên website hoặc liên hệ Pay2S để được tư vấn theo nhu cầu.

Bắt đầu kết nối ACB với hệ thống của bạn

Kết nối ACB qua Pay2S giúp đưa dữ liệu thanh toán vào website và phần mềm, giảm việc kiểm tra chuyển khoản thủ công và hỗ trợ xử lý đơn hàng tự động.

Bạn có thể bắt đầu bằng việc liên kết tài khoản ACB, chọn luồng tích hợp phù hợp và kiểm thử một giao dịch trước khi đưa vào vận hành.

Tạo tài khoản và bắt đầu với Pay2S · Xem tài liệu tích hợp

    Chia sẻ bài viết