Kết nối thanh toán: SePay hoặc PayOS

Tiền đi đâu

Người xem chuyển khoản thẳng vào tài khoản ngân hàng của bạn. Viescan không giữ, không nhận hộ và không chuyển tiền donation. Viescan chỉ cần biết khi tiền về để hiện alert, nên bạn kết nối tài khoản SePay hoặc PayOS của chính bạn.

Bạn cần có

• Tài khoản SePay hoặc PayOS, và tài khoản ngân hàng của bạn đã gắn vào đó.
• Phí của SePay hay PayOS (nếu có) do bạn tự trả cho họ, Viescan không thu.

Kết nối SePay

Mở trang Thanh toán của dashboard và chọn SePay. Trang đó có cùng các bước này, kèm địa chỉ webhook của riêng bạn.

1. 1Tạo tài khoản SePay và gắn tài khoản ngân hàng. Ngân hàng chỉ nhận tiền qua tài khoản ảo (VA), như KienlongBank, thì tạo một VA.
2. 2Trong SePay, vào Cấu hình công ty → Cấu hình chung → Cấu trúc mã thanh toán: tiền tố HX, hậu tố 7 ký tự, kiểu chữ và số.
3. 3Ở trang Thanh toán của Viescan, bấm "Sao chép URL webhook".
4. 4Trong SePay, vào Tích hợp → Webhooks → Thêm webhook. Thẻ Cơ bản: đặt tên; dán địa chỉ vào ô "URL nhận webhook"; "Loại giao dịch" Tiền vào; "Định dạng dữ liệu" JSON; bật "Tự động gửi lại khi server trả lỗi".
5. 5Thẻ Tài khoản: "Chọn cụ thể" tài khoản ngân hàng cùng VA của nó; "Bộ lọc tiền tố mã thanh toán" HX; bật "Bỏ qua giao dịch không có mã".
6. 6Thẻ Bảo mật: "Phương thức xác thực" HMAC-SHA256; bấm nút ↻ ở ô Secret Key để SePay sinh khóa (bắt đầu bằng whsec_), rồi chép khóa vào ô Secret Key ở trang Thanh toán của Viescan trước khi lưu webhook.
7. 7Thẻ Cảnh báo: để mặc định. Lưu webhook, rồi dùng ⋮ → "Gửi thử" để thử.
8. 8Trong SePay, vào Cấu hình công ty → API Access, tạo API Token và chép vào ô API Token ở trang Thanh toán của Viescan.
9. 9Bấm "Kiểm tra kết nối". Viescan cho biết tiền sẽ về tài khoản nào và thay đổi có phải chờ 24 giờ hay không. Chọn đúng tài khoản hoặc VA, nhập mã gửi về Gmail của bạn, rồi bấm "Lưu kết nối".

Token của SePay có toàn quyền với tài khoản SePay của bạn; Viescan chỉ dùng nó để đọc giao dịch và lưu ở dạng mã hóa.

Kết nối PayOS

1. 1Tạo tài khoản PayOS, xác thực và gắn tài khoản ngân hàng.
2. 2Tạo một kênh thanh toán riêng cho Viescan. Viescan đặt địa chỉ webhook của kênh ngay khi bạn bấm "Kiểm tra kết nối", nên kênh đang dùng cho việc khác sẽ mất webhook cũ.
3. 3Mở trang Thanh toán của dashboard, chọn PayOS, rồi chép Client ID, API Key, Checksum Key của kênh vào các ô. Viescan tự đăng ký webhook.
4. 4Bấm "Kiểm tra kết nối". Viescan cho biết tiền sẽ về tài khoản nào và thay đổi có phải chờ 24 giờ hay không. Nhập mã gửi về Gmail của bạn, rồi bấm "Lưu kết nối".

Donation được xác nhận thế nào

• Mỗi donation có một mã riêng, là nội dung chuyển khoản. Donation được xác nhận khi SePay hay PayOS báo một giao dịch khớp với mã đó.
• Viescan còn tự đối chiếu lại với SePay hay PayOS để bắt giao dịch có thông báo bị lỡ.
• Người xem phải giữ nguyên nội dung chuyển khoản và chuyển từ 5.000đ; sai nội dung thì không có alert.
• Chuyển khác số đã chọn mà từ 5.000đ trở lên thì ghi nhận theo số tiền thực nhận.
• Tiền tới sau thời hạn thanh toán nhưng trong 72 giờ vẫn được ghi nhận.

Xem trạng thái

Trạng thái kết nối ở trang Thanh toán; từng giao dịch ở tab Đối chiếu của mục Thống kê.

Hỏi đáp

Xem thêm

• PhíPhí nền tảng, ai trả gì
• Lỗi thường gặpOverlay không hiện alert, donation chờ lâu, alert không đọc