ChatHub/docs

Tìm kiếm tài liệu

GỢI Ý CHO BẠN135 kết quả

Tìm trong các bài viết · Theo từng mục

Di chuyểnMởescĐóngChatHub docs
CẤU HÌNH HỆ THỐNGCấu hình thanh toán ngân hàng qua Pay2S
Hướng dẫn cấu hìnhHướng dẫn admin

Cấu hình thanh toán ngân hàng qua Pay2S

Hướng dẫn liên kết ngân hàng, tạo webhook Pay2S, lưu khóa bảo mật và thông tin nhận tiền trong ChatHub để tự động cộng số dư.

ChatHub Team·10 phút đọc

Pay2S hoạt động với ChatHub như thế nào?#

Khi khách bắt đầu bước workflow Nạp số dư qua Pay2S, ChatHub tạo một mã đối chiếu bắt đầu bằng NAP và gửi hướng dẫn chuyển khoản. Pay2S theo dõi tài khoản ngân hàng đã liên kết, đẩy giao dịch tiền vào đến webhook của ChatHub; giao dịch có đúng mã và số tiền dương sẽ được ghi nhận để cộng vào ví khách.

  1. 1

    Liên kết tài khoản ngân hàng nhận tiền với Pay2S.

  2. 2

    Tạo webhook Tiền vào trên Pay2S bằng địa chỉ do ChatHub cung cấp.

  3. 3

    Sao chép secret key của webhook và lưu cùng thông tin tài khoản nhận tiền trong ChatHub.

  4. 4

    Dùng workflow có bước Nạp số dư qua Pay2S, rồi kiểm tra một giao dịch thử có đúng mã đối chiếu.

1. Chuẩn bị trước khi cấu hình#

  1. 1

    Tài khoản ChatHub có quyền mở Quản trị → Cài đặt → Thanh toán.

  2. 2

    Tài khoản Pay2S đang sử dụng được và một tài khoản ngân hàng thuộc danh sách Pay2S hỗ trợ. Chuẩn bị phương thức đăng nhập, thông tin chủ tài khoản và OTP nếu ngân hàng yêu cầu.

  3. 3

    Tên miền ChatHub chính thức có HTTPS và Pay2S truy cập được từ Internet. Không dùng địa chỉ localhost hoặc tên miền DDEV chỉ hoạt động trên máy cá nhân cho webhook thật.

  4. 4

    Chọn trước tài khoản ngân hàng sẽ nhận tiền. Tên ngân hàng, số tài khoản và chủ tài khoản nhập trong ChatHub phải đúng với tài khoản này để khách chuyển khoản chính xác.

Secret key của webhook là thông tin nhạy cảm. Chỉ sao chép từ Pay2S sang ô Khoá webhook trong ChatHub; không đưa vào tài liệu, ảnh chụp, mã nguồn hoặc tin nhắn hỗ trợ.

Mở bảng điều khiển Pay2S ↗

3. Lấy địa chỉ webhook từ ChatHub#

  1. 1

    Trong ChatHub, mở Quản trị → Cài đặt và chọn tab Thanh toán.

  2. 2

    Mở thẻ Pay2S trong nhóm Chuyển khoản ngân hàng.

  3. 3

    Ở Địa chỉ webhook, bấm Sao chép. Địa chỉ có dạng https://ten-mien-chathub-cua-ban/api/payments/pay2s/webhook.

  4. 4

    Kiểm tra địa chỉ đang dùng tên miền chính thức có HTTPS trước khi dán sang Pay2S.

Trong Cài đặt, chọn Thanh toán ở cột trái. Khối Phương thức nhận tiền cho biết số phương thức đã sẵn sàng; mở thẻ Pay2S ở phần bên dưới để cấu hình.
Biểu mẫu Pay2S trong ChatHub. Nút Sao chép nằm cạnh Địa chỉ webhook; bên dưới là Khoá webhook, Ngân hàng, Số tài khoản và Chủ tài khoản. chathub.ddev.site, 0000000000 và NGUYEN VAN A chỉ là dữ liệu minh họa chưa lưu; hãy dùng tên miền công khai và thông tin nhận tiền thật của bạn.

4. Tạo webhook Tiền vào trên Pay2S#

  1. 1

    Quay lại Pay2S, mở Webhooks → Danh sách webhook và bấm Thêm webhook.

  2. 2

    Đặt Tên webhook dễ nhận biết, ví dụ ChatHub - tiền vào.

  3. 3

    Ở Chọn sự kiện, chọn Tiền vào. Chọn đúng tài khoản ngân hàng đã liên kết ở bước 2.

  4. 4

    Dán địa chỉ vừa sao chép từ ChatHub vào Gọi đến URL (Webhook URL).

  5. 5

    Giữ Cấu trúc mã thanh toán ở Không giới hạn theo mã thanh toán để ChatHub tự đối chiếu mã NAP trong nội dung giao dịch. Không cần bật Nhận thông tin xuất hóa đơn cho luồng nạp ví này.

  6. 6

    Kiểm tra lại tài khoản, sự kiện và URL, sau đó bấm Thêm webhook.

Biểu mẫu Thêm webhook mới trên Pay2S. Sự kiện Tiền vào đang được chọn; cần chọn tài khoản ngân hàng ở ô tiếp theo. URL chathub.example.com là ví dụ, biểu mẫu chưa được gửi và chưa tạo webhook.

5. Sao chép secret key và lưu trong ChatHub#

  1. 1

    Ngay sau khi tạo webhook, sao chép token/secret key Pay2S hiển thị. Theo tài liệu Pay2S, khóa này chỉ xuất hiện một lần trong quá trình tạo webhook.

  2. 2

    Quay lại thẻ Pay2S trong ChatHub và dán khóa vào Khoá webhook (secret key).

  3. 3

    Nhập Ngân hàng, Số tài khoản và Chủ tài khoản đúng như tài khoản nhận tiền trên Pay2S. Ba giá trị này được chèn vào hướng dẫn chuyển khoản mà workflow gửi cho khách.

  4. 4

    Bấm Lưu và chờ thông báo Đã lưu cài đặt thanh toán. Thẻ Pay2S phải chuyển sang Đã cấu hình.

Sau khi lưu, ChatHub không gửi khóa đã cất trở lại trình duyệt. Khi chỉ sửa thông tin ngân hàng, để trống ô khóa để giữ secret key hiện tại. Chỉ dán khóa mới khi bạn đã tạo lại hoặc thay token của webhook Pay2S.

6. Dùng Pay2S trong workflow nạp số dư#

  1. 1

    Mở Tự động hoá → Workflow và chọn workflow bán hàng hoặc nạp số dư cần dùng chuyển khoản ngân hàng.

  2. 2

    Thêm hoặc kiểm tra bước Nạp số dư qua Pay2S. Nếu giao diện báo Cần cấu hình Pay2S, quay lại bước 5 và kiểm tra secret key đã được lưu.

  3. 3

    Đảm bảo workflow gửi cho khách đúng ngân hàng, số tài khoản, chủ tài khoản, số tiền và mã đối chiếu do bước Pay2S tạo.

  4. 4

    Bật workflow sau khi đã rà nhánh thành công, lỗi và hủy; tránh để nhiều workflow cùng chào hoặc cùng xử lý một khách nếu đó không phải chủ ý.

Xem hướng dẫn sử dụng Workflow ↗

7. Kiểm tra nhận tiền và cộng số dư#

  1. 1

    Dùng một liên hệ kiểm thử chạy đến bước Nạp số dư qua Pay2S và ghi lại số tiền cùng mã NAP mà ChatHub cung cấp.

  2. 2

    Chuyển đúng số tiền vào đúng tài khoản, nhập nguyên mã NAP vào nội dung chuyển khoản. Một giao dịch chỉ nên dùng cho một lần thử.

  3. 3

    Trong Pay2S, mở Giao dịch ngân hàng để xác nhận khoản tiền vào đã được đồng bộ; mở Webhooks → Lịch sử giao dịch để kiểm tra yêu cầu gửi đến ChatHub.

  4. 4

    Trong ChatHub, kiểm tra workflow tiếp tục, ví khách tăng đúng số tiền và lịch sử biến động ghi nguồn cổng thanh toán.

Đây là giao dịch tiền thật. Chỉ thử với số tiền nhỏ theo quy trình nội bộ và giữ lại mã giao dịch để đối soát nếu cần.

8. Xử lý lỗi thường gặp#

  1. 1

    Pay2S không nhận giao dịch: kiểm tra tài khoản ngân hàng đang hoạt động, phiên liên kết/OTP còn hiệu lực và giao dịch xuất hiện trong Giao dịch ngân hàng.

  2. 2

    Webhook không chạy: kiểm tra webhook đang bật, sự kiện là Tiền vào, chọn đúng tài khoản và URL dùng HTTPS công khai. Xem mã phản hồi tại Lịch sử giao dịch của webhook.

  3. 3

    ChatHub trả lỗi 401: secret key trong ChatHub không khớp token của webhook. Tạo/copy lại token theo Pay2S rồi lưu khóa mới trong ChatHub.

  4. 4

    Có webhook nhưng ví không tăng: kiểm tra số tiền dương, nội dung có nguyên mã NAP của phiên đang chờ và mã chưa được dùng cho giao dịch khác.

  5. 5

    Thông tin chuyển khoản gửi cho khách sai: sửa Ngân hàng, Số tài khoản hoặc Chủ tài khoản trong ChatHub và bấm Lưu; không cần thay secret key nếu webhook vẫn giữ nguyên.

  6. 6

    Pay2S sẽ gửi lại khi endpoint chưa trả HTTP 200. Không tạo thêm nhiều webhook giống nhau để xử lý lỗi vì có thể làm việc đối soát khó hơn.

9. Bảo mật và vận hành#

  1. 1

    Giới hạn người có quyền truy cập Cài đặt Thanh toán và tài khoản Pay2S.

  2. 2

    Không dùng chung secret key qua email, chat nhóm hoặc tài liệu công khai. Nếu nghi khóa lộ, thay token webhook và cập nhật ChatHub ngay.

  3. 3

    Theo dõi Lịch sử giao dịch webhook để phát hiện lỗi hoặc timeout; đối chiếu giao dịch ngân hàng với biến động ví trước khi điều chỉnh thủ công.

  4. 4

    Khi đổi tài khoản nhận tiền, cập nhật cả Pay2S, webhook và ba trường thông tin ngân hàng trong ChatHub trước khi cho workflow hoạt động lại.

Cấu hình thanh toán ngân hàng qua Pay2SVề đầu trang
© 2026 ChatHub DocsPowered by CMSNT LTDTài liệu hướng dẫn sử dụng ChatHub.