Hướng dẫn

Kết nối ngân hàng nhận donate qua SePay hoặc Pay2S

Đăng ngày 31/10/2026 · 5 phút đọc

Nhận donate tự động bằng mã QR ngân hàng. Tiền chuyển thẳng vào tài khoản ngân hàng của bạn. VTPay không giữ tiền; SePay chỉ báo cho VTPay biết khi có tiền vào để hiện donate lên live.

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

Truy cập sepay.vn, đăng ký tài khoản và xác thực thông tin theo hướng dẫn của SePay.

Bước 2: Kết nối tài khoản ngân hàng

Trên SePay, chọn Ngân hàng → Kết nối tài khoản, hoặc mở my.sepay.vn/bankaccount/connect.

Quan trọng: thêm từ khóa VTPAY

Nội dung chuyển khoản của mọi đơn donate trên VTPay đều bắt đầu bằng VTPAY. Ô Đồng bộ giao dịch theo từ khóa của SePay là bộ lọc: khi ô đã có từ khóa (ví dụ ZYPAGE của nền tảng khác), SePay bỏ qua mọi giao dịch không chứa các từ khóa đó. Thiếu VTPAY thì donate sẽ không về VTPay.

Cách làm khi đã liên kết sẵn ngân hàng:

Trang Ngân hàng trên SePay: mục Ngân hàng ở menu trái và thẻ tài khoản đã kết nối được khoanh đỏ — **(1)** Bấm *Ngân hàng* ở menu trái. **(2)** Bấm vào tài khoản ngân hàng đã kết nối.

Trang chi tiết tài khoản trên SePay, ô Cấu hình chung được khoanh đỏ — **(3)** Bấm *Cấu hình chung*.

Ô Đồng bộ giao dịch theo từ khóa có ZYPAGE và VTPAY, VTPAY được khoanh đỏ — **(4)** Ở ô *Đồng bộ giao dịch theo từ khóa*, gõ `VTPAY` rồi nhấn Enter. SePay tự lưu; tải lại trang để chắc từ khóa vẫn còn. Giữ nguyên từ khóa của nền tảng khác nếu bạn còn dùng.

Về tài khoản ảo

VTPay tạo mã QR tới số tài khoản chính bạn khai báo và đối chiếu theo số tài khoản đó. Hãy chọn ngân hàng nhận được giao dịch vào tài khoản chính qua SePay.

MB Bank, ACB, VPBank, TPBank, VietinBankDùng được với số tài khoản chính

BIDV, OCBSePay bắt buộc tài khoản ảo: VTPay chưa hỗ trợ

Với MB Bank, không nên tạo tài khoản ảo vì hay bị lỗi.

Bước 3: Thêm webhook thanh toán trên SePay

Mở Tích hợp WebHooks (my.sepay.vn/webhooks), bấm Thêm webhooks và điền như sau:

Gọi đến URL: URL webhook riêng của bạn, chép ở trang Thanh toán → Ngân hàng (QR Code) · SePay → ô URL webhook.
Là WebHooks xác thực thanh toán?: Đúng
Gọi lại WebHooks khi?: Tích vào ô (SePay gửi lại khi chưa nhận được phản hồi)
Kiểu chứng thực: API Key
API Key: Một chuỗi dài bất kỳ, ít nhất 32 ký tự (chữ, số, _ hoặc -). Có thể bấm Tạo khóa ngẫu nhiên ở trang Thanh toán của VTPay rồi dán sang SePay.

Ô URL webhook và API Key trên trang Thanh toán của VTPay — **(2)** chép URL webhook dán vào ô *Gọi đến URL* của SePay. **(3)** API Key: bấm *Tạo khóa ngẫu nhiên* rồi dán cùng khóa đó sang SePay.

API Key giống như mật khẩu: không gửi cho ai, không đăng lên mạng. Ai có khóa này có thể giả thông báo tiền vào.

Bước 4: Điền thông tin vào VTPay

Vào Thanh toán → + Thêm phương thức (hoặc Chỉnh sửa) → Ngân hàng (QR Code) · SePay:

Nút Thêm phương thức và Chỉnh sửa trên trang Thanh toán — **(1)** Bấm *+ Thêm phương thức* (lần đầu) hoặc *Chỉnh sửa* (đã có) ở dòng Ngân hàng (QR Code) · SePay.

API Key: đúng khóa bạn đã điền ở SePay (bước 3).
Ngân hàng, Số tài khoản, Chủ tài khoản: đúng tài khoản đã kết nối với SePay ở bước 2.
Tích ba mục trong Kiểm tra trước khi kết nối, rồi bấm Lưu kết nối.

Ba mục Kiểm tra trước khi kết nối đã tích và nút Lưu kết nối — **(4)** Chọn ngân hàng, nhập số tài khoản và chủ tài khoản (ảnh trên). **(5)** Tích đủ ba mục kiểm tra. **(6)** Bấm *Lưu kết nối*.

Tài khoản đầu tiên dùng được ngay. Đổi sang tài khoản ngân hàng khác thì cần quản trị viên duyệt.

Bước 5: Thử thanh toán

Trước khi chia sẻ trang cho người xem, hãy tự donate một khoản nhỏ trên trang của bạn:

Mở trang donate của bạn, đăng nhập, nhập số tiền và bấm Tạo lệnh donate.
Quét mã QR bằng app ngân hàng và chuyển đúng số tiền, giữ nguyên nội dung.
Sau vài giây, trang báo đã nhận tiền và donate xuất hiện ở Lịch sử donate, Đơn hàng và trên OBS.

Màn hình chuyển khoản với mã QR và nội dung chuyển khoản — **(1)** Quét mã QR bằng app ngân hàng. **(2)** Giữ nguyên nội dung `VTPAY …`; trang tự báo khi nhận được tiền.

Theo dõi gói giao dịch bạn đang dùng trên SePay. Hết lượt của gói thì SePay ngừng báo giao dịch và donate sẽ không được xác nhận tự động.

Cách khác: kết nối qua Pay2S

Pay2S là cổng báo giao dịch thay cho SePay. Gói trả phí của Pay2S từ 150.000đ/tháng, không giới hạn số giao dịch và không thu phí trên từng giao dịch. Với Pay2S bạn không cần thêm từ khóa VTPAY: Pay2S gửi nguyên nội dung chuyển khoản, VTPay tự tìm mã đơn.

Đăng ký tài khoản tại my.pay2s.vn và chọn gói phù hợp.
Trên Pay2S: Ngân hàng → Thêm tài khoản, chọn ngân hàng, kiểu kết nối OpenAPI, nhập thông tin và mã OTP ngân hàng gửi về.
Link webhook dùng chung cho mọi trang: https://vtpay.vn/api/v1/webhooks/pay2s (cũng hiện ở Thanh toán → Ngân hàng (QR Code) → Kết nối qua Pay2S).
Trên Pay2S: Webhooks → Thêm webhook. Chọn tài khoản vừa liên kết, sự kiện Nhận tiền, ô Endpoint dán link vừa chép, rồi lưu.
Pay2S hiện token của webhook một lần duy nhất: chép ngay, dán vào ô Token Pay2S trên VTPay.
Nhập ngân hàng, số tài khoản, chủ tài khoản (đúng tài khoản đã liên kết trên Pay2S), tích ba mục kiểm tra rồi bấm Lưu kết nối.
Tự donate thử một khoản nhỏ như bước 5. Dòng trạng thái Pay2S trên trang Thanh toán sẽ hiện lần cuối nhận dữ liệu.

Token Pay2S giống như mật khẩu: không gửi cho ai. Lỡ làm mất token thì xóa webhook cũ trên Pay2S, tạo webhook mới và dán token mới vào VTPay.

Gói Free của Pay2S chỉ có 50 giao dịch mỗi tháng; quá mức thì donate không được xác nhận tự động cho tới khi bạn nâng gói. Có thể dùng SePay và Pay2S cùng lúc: VTPay ghi nhận mỗi giao dịch một lần.

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

Đã chuyển tiền nhưng donate không hiện

Kiểm tra lại: webhook trên SePay đúng URL của bạn, API Key hai bên giống hệt nhau, và nội dung chuyển khoản còn nguyên mã VTPAY…. Khoản chuyển thiếu mã hoặc lệch số tiền được xem là không hợp lệ: tiền vẫn vào tài khoản ngân hàng của bạn, nhưng không hiện lên live và không hiện trong Lịch sử donate. Giao dịch có từ khóa của nền tảng khác (ví dụ ZYPAGE) được VTPay bỏ qua.

Nên chọn ngân hàng nào?

Ngân hàng nhận giao dịch vào tài khoản chính qua SePay, ví dụ MB Bank hoặc ACB. BIDV và OCB bắt buộc tài khoản ảo nên chưa dùng được.

VTPay có giữ tiền của tôi không?

Không. Người xem chuyển thẳng vào tài khoản ngân hàng của bạn; VTPay chỉ nhận thông báo từ SePay để xác nhận donate.