Cấu hình thanh toán: Pay2S, SePay, PayOS và chuyển khoản

Trang Thanh toán dùng để làm gì?#

Admin › Cài đặt › Thanh toán là trung tâm thu tiền của nền tảng: khách chỉ mua được gói khi có ít nhất một phương thức nhận tiền. LDPage hỗ trợ chuyển khoản ngân hàng (khách quét mã QR) và ba cổng: Pay2S và SePay theo dõi tài khoản ngân hàng rồi gửi webhook khi tiền vào để hệ thống tự đối soát; PayOS chuyển khách sang trang thanh toán của PayOS và kích hoạt tự động.

1. Đọc dải trạng thái và danh sách Hoàn tất thiết lập#

1. 1

   Mở menu tài khoản › Quản trị SaaS › Cài đặt, chọn Thanh toán ở nhóm Nền tảng bên trái.

2. 2

   Dải 4 thẻ đầu trang: Phương thức nhận tiền (0 = Khách chưa mua gói được), Tự kích hoạt gói (Đang bật, Chưa chạy hoặc Đang tắt), Doanh thu 30 ngày và Webhook 24 giờ. Bấm một thẻ để tới mục liên quan.

3. 3

   Tự kích hoạt gói hiện Chưa chạy khi đã bật cổng tự đối soát nhưng chưa có tài khoản nhận chuyển khoản; khi đó đơn vẫn phải xác nhận tay.

4. 4

   Khối Hoàn tất thiết lập có 4 bước: Tài khoản nhận tiền, Bật cổng thanh toán, Nhận webhook đầu tiên, Thông tin bên bán. Bấm từng bước để mở đúng mục còn thiếu; khối tự ẩn khi đủ 4 bước.

5. 5

   Bên dưới là 4 mục: Cổng thanh toán (kèm số cổng đang hoạt động, ví dụ 1/3), Chuyển khoản, Chính sách và Nhật ký webhook.

2. Thẻ cổng thanh toán#

1. 1

   Mục Cổng thanh toán hiển thị một thẻ cho mỗi cổng: Pay2S và SePay (nhãn Tự đối soát chuyển khoản), PayOS (nhãn Trang thanh toán).

2. 2

   Công tắc góc phải thẻ bật/tắt nhanh cổng. Tắt cổng đang chạy sẽ hỏi lại: webhook từ cổng bị từ chối và đơn chuyển khoản phải xác nhận tay cho tới khi bật lại (với PayOS, khách không còn thấy lựa chọn thanh toán qua cổng).

3. 3

   Ba số liệu: Webhook 24h, Kích hoạt 24h (số đơn được kích hoạt) và Gần nhất (thời điểm webhook gần nhất). Nếu có webhook bị từ chối, thẻ báo key/token chưa khớp kèm nút Xem.

4. 4

   Nhãn trạng thái: Đang hoạt động, Đang tắt (đủ cấu hình nhưng chưa bật), Thiếu cấu hình (đã bật nhưng thiếu trường) hoặc Chưa cấu hình.

5. 5

   Ba nút cuối thẻ: Nhật ký (mở Nhật ký webhook lọc theo cổng), Tài liệu (mở tài liệu tích hợp của nhà cung cấp) và Cấu hình (mở hộp cấu hình).

3. Cấu hình Pay2S, SePay hoặc PayOS#

1. 1

   Bấm Cấu hình trên thẻ cổng. Ô URL webhook ở đầu hộp có dạng <tên miền của bạn>/api/v1/payments/<cổng>/webhook; bấm nút sao chép để dán vào trang quản trị của cổng.

2. 2

   Khối Kiểm tra kết nối là danh sách tự kiểm: Đủ trường bắt buộc (hoặc Thiếu n trường bắt buộc), URL webhook công khai (HTTPS) và trạng thái webhook gần nhất (Chưa nhận webhook nào, Webhook hợp lệ lúc…, hoặc bị từ chối vì key/token chưa khớp). Máy chủ của cổng chỉ gọi được URL công khai có HTTPS.

3. 3

   Mở Hướng dẫn khai báo để xem các bước làm trên trang của cổng, có sẵn URL webhook của bạn.

4. 4

   Pay2S: trên pay2s.vn, liên kết tài khoản ngân hàng trùng với tài khoản nhận ở mục Chuyển khoản; vào Webhooks › Thêm webhook, chọn tài khoản, sự kiện Nhận tiền, Endpoint = URL webhook. Sao chép token Pay2S hiển thị (chỉ hiện một lần) vào ô Token của Hook. Ô Chỉ nhận giao dịch vào số tài khoản dùng khi Pay2S liên kết nhiều ngân hàng; để trống = nhận mọi tài khoản đã liên kết.

5. 5

   SePay: trên my.sepay.vn, liên kết tài khoản ngân hàng nhận chuyển khoản; vào Tích hợp Webhooks › Thêm webhook, sự kiện Có tiền vào, URL = URL webhook; chọn kiểu chứng thực API Key và nhập cùng một chuỗi bí mật ở cả SePay và ô API Key webhook.

6. 6

   PayOS: tạo kênh thanh toán trên my.payos.vn, sao chép Client ID, API Key và Checksum Key vào các ô tương ứng; trong kênh thanh toán đặt Webhook URL = URL webhook rồi bấm Kiểm tra bên PayOS.

7. 7

   Trường bí mật (token, key) được mã hoá khi lưu; sau khi lưu, ô hiển thị gợi ý giá trị đã lưu và bạn để trống nếu muốn giữ nguyên. Nút con mắt hiện/ẩn giá trị đang gõ.

8. 8

   Bật công tắc Bật cổng <tên cổng> (cần đủ trường bắt buộc) rồi bấm Lưu.

9. 9

   Chuyển thử một khoản nhỏ có nội dung là mã đơn để kiểm tra; kết quả hiện ở Nhật ký webhook.

4. Khai báo tài khoản nhận chuyển khoản#

1. 1

   Mở mục Chuyển khoản. Thẻ Tài khoản nhận tiền cho biết cổng nào đang tự đối soát; nếu đã bật SePay/Pay2S mà chưa có tài khoản, dải vàng nhắc nhập tài khoản để cổng tự đối soát.

2. 2

   Ngân hàng: gõ tên hoặc mã BIN để tìm trong danh sách. Nếu không có ngân hàng của bạn, bấm Nhập mã BIN để tự nhập Mã BIN (6 số) và Tên ngân hàng hiển thị. Mã BIN là mã ngân hàng theo chuẩn VietQR, dùng để tạo ảnh QR.

3. 3

   Nhập Số tài khoản và Chủ tài khoản (viết hoa không dấu như trên ngân hàng).

4. 4

   Mã đơn & thời hạn: Tiền tố mã đơn (tối đa 10 chữ in hoa và số, mặc định PF) là phần đầu mã đơn mà khách ghi vào nội dung chuyển khoản; ô bên cạnh hiện ví dụ mã đơn. Đổi tiền tố khi còn đơn chờ dùng tiền tố cũ thì các đơn đó phải xác nhận tay.

5. 5

   Đơn chờ hết hạn sau: 1–168 giờ (mặc định 48), có nút nhanh 24 giờ, 48 giờ, 72 giờ, 7 ngày. Quá hạn, đơn chuyển sang Hết hạn; tiền về muộn vẫn xác nhận được ở Admin › Đơn hàng.

6. 6

   Cột Khách sẽ thấy bên phải xem trước đúng khối thanh toán của khách: ảnh QR mẫu, ngân hàng, số tài khoản, chủ tài khoản, số tiền và nội dung chuyển khoản. Hãy quét thử QR bằng ứng dụng ngân hàng trước khi mở bán.

7. 7

   Muốn tạm ngừng nhận chuyển khoản, bấm Ngừng nhận ở thẻ Tài khoản nhận tiền; thay đổi có hiệu lực sau khi bấm Lưu.

5. Chính sách đăng ký, ân hạn và thông tin bên bán#

1. 1

   Mở mục Chính sách. Đăng ký & xác minh: Cho phép khách tự đăng ký tài khoản (tắt nếu chỉ muốn tạo tài khoản thủ công) và Bắt buộc xác minh email.

2. 2

   Gia hạn gói: Thời gian ân hạn 0–60 ngày (mặc định 3; nút nhanh Không ân hạn, 3, 7, 14 ngày). Hết ân hạn, hệ thống tự gỡ xuất bản trang và tạm ngưng tên miền vượt mức gói.

3. 3

   Chương trình giới thiệu: chỉ hiển thị trạng thái; bấm Cấu hình để sang Admin › Giới thiệu.

4. 4

   Thông tin bên bán: Tên đơn vị bán, Mã số thuế, Địa chỉ. Các thông tin này được in trên biên nhận thanh toán; khung Xem trước biên nhận bên phải cập nhật theo nội dung bạn gõ.

6. Lưu thay đổi và xem Nhật ký webhook#

1. 1

   Hai mục Chuyển khoản và Chính sách dùng chung một form: chuyển qua lại không mất thay đổi; tab có thay đổi chưa lưu được đánh dấu. Lưu bằng thanh lưu nổi ở đáy màn hình (nút Lưu, Huỷ) hoặc phím Ctrl/⌘ + S. Rời trang khi còn thay đổi chưa lưu sẽ có cảnh báo.

2. 2

   Cấu hình cổng được lưu riêng bằng nút Lưu trong hộp Cấu hình của từng cổng.

3. 3

   Mục Nhật ký webhook liệt kê mọi bản tin cổng gửi tới với các cột Thời gian, Cổng, Kết quả, Đơn, Ghi chú. Lọc theo cổng, theo kết quả (Đã kích hoạt đơn, Hợp lệ, không kích hoạt, Bị từ chối (sai xác thực)) hoặc tìm theo mã đơn, mã giao dịch.

4. 4

   Webhook hợp lệ nhưng không kích hoạt đơn (sai nội dung, chuyển thiếu…) sẽ nằm trong Giao dịch chưa khớp ở Admin › Đơn hàng để bạn gán tay.

Xử lý vướng mắc#

1. 1

   Webhook bị từ chối (sai xác thực): token Pay2S, API Key SePay hoặc Checksum Key PayOS không khớp. Nhập lại giá trị ở cả hai phía rồi Lưu.

2. 2

   Kiểm tra kết nối báo URL webhook chưa công khai: máy chủ đang chạy local hoặc chưa có HTTPS; cổng không gọi được. Triển khai lên tên miền thật có HTTPS.

3. 3

   Tiền đã về nhưng đơn không kích hoạt: khách ghi sai nội dung (thiếu mã đơn), chuyển thiếu, hoặc tài khoản nhận ở mục Chuyển khoản khác tài khoản liên kết với cổng. Xem Nhật ký webhook và xử lý trong Giao dịch chưa khớp.

4. 4

   Bật cổng nhưng Tự kích hoạt gói vẫn Chưa chạy: Pay2S/SePay cần tài khoản nhận chuyển khoản ở mục Chuyển khoản.

5. 5

   Ô cấu hình hiện Đang dùng giá trị env: giá trị đang lấy từ biến môi trường của máy chủ (ví dụ SEPAY_WEBHOOK_KEY, PAYOS_CLIENT_ID).