Hướng dẫn tích hợp module Sepay cho Perfex CRM
🔑 Thông tin Đăng nhập Demo
Các tính năng chính
Khám phá toàn bộ tính năng
Để xem chi tiết danh sách tất cả các tính năng nổi bật của phần mềm/module, vui lòng truy cập trang mô tả sản phẩm.
Xem chi tiếtHướng dẫn Cài đặt
Bước 1: Vào trang https://my.sepay.vn/ tạo tài khoản
Bước 2: Chọn gói dịch vụ phù hợp: Miễn phí/ trả phí
Bước 3: Liên kết tài khoản ngân hàng nhận tiền vào
Bước 4: Thêm các thông tin tích hợp trong https://my.sepay.vn/webhooks
Ví dụ thay đường dẫn CRM của bạn:
- https://democrm.scovietnam.com/sepay/webhook
- https://democrm.scovietnam.com/sepay/sepay_server/ipn
Vào phần tích hợp cổng thanh toán: https://my.sepay.vn/pg/payment-methods
Làm theo lần lượt để lấy thông tin ID và key để cấu hình vào môi trường test, khi nào test xong thì chuyển sang chính thức.
Nếu muốn sử dụng nhiều hình thức thanh toán qua Sepay cần phải ký kết hợp đồng. Còn mặc định chỉ có phần quét mã QR
Hướng dẫn Sử dụng
1. Sepay là gì?
SePay là dịch vụ giúp tự động xác nhận thanh toán chuyển khoản ngân hàng thông qua nội dung chuyển khoản.
Khi tích hợp vào Perfex CRM, hệ thống có thể:
-
Tự động xác nhận thanh toán Invoice
-
Tự động cập nhật trạng thái hóa đơn
-
Không cần kiểm tra chuyển khoản thủ công
2. Điều kiện trước khi tích hợp
Trước khi cài module Sepay, cần chuẩn bị:
Tài khoản Sepay
Đăng ký tài khoản tại website Sepay và tạo:
-
API Key
-
Webhook URL
Hệ thống Perfex CRM
Yêu cầu:
-
Perfex CRM đã cài đặt
-
PHP 7.4 trở lên
-
Cho phép cài module
3. Cài đặt Module Sepay vào Perfex CRM
Bước 1: Upload module
-
Đăng nhập Admin Panel Perfex CRM
-
Vào:
-
Chọn Upload Module
Upload file:
Bước 2: Kích hoạt module
Sau khi upload:
4. Cấu hình Sepay trong Perfex CRM
Sau khi kích hoạt:
Chọn:
Nhập các thông tin:
| Thông tin | Mô tả |
|---|---|
| API Key | API từ Sepay |
| Bank Code | Mã ngân hàng |
| Account Number | Số tài khoản nhận tiền |
| Webhook Secret | Mã bảo mật webhook |
5. Cấu hình Webhook
Trong trang quản trị Sepay cần cấu hình:
Webhook giúp hệ thống:
-
Nhận thông báo khi có giao dịch
-
Kiểm tra nội dung chuyển khoản
-
Tự động xác nhận thanh toán
6. Cấu hình nội dung chuyển khoản
Khi khách thanh toán invoice, hệ thống sẽ yêu cầu khách chuyển khoản với nội dung:
Trong đó:
-
INV1234 = mã hóa đơn
Sepay sẽ đọc nội dung này để:
-
xác định hóa đơn
-
cập nhật trạng thái thanh toán
7. Quy trình hoạt động
Luồng thanh toán:
↓
Chuyển khoản ngân hàng
↓
Sepay đọc giao dịch
↓
Sepay gửi Webhook
↓
Perfex CRM xác nhận thanh toán
↓
Invoice → Paid
8. Kiểm tra hoạt động
Sau khi cấu hình xong:
-
Tạo Invoice test
-
Chuyển khoản với nội dung đúng
-
Kiểm tra trạng thái
Nếu hoạt động đúng:
9. Các lỗi thường gặp
Không nhận webhook
Nguyên nhân:
-
Webhook URL sai
-
Server chặn request
-
SSL lỗi
Không nhận diện được hóa đơn
Nguyên nhân:
-
Nội dung chuyển khoản sai
-
Khách không ghi đúng mã invoice
Không cập nhật trạng thái
Nguyên nhân:
-
API Key sai
-
Module chưa kích hoạt
10. Lợi ích khi tích hợp Sepay với Perfex CRM
Khi sử dụng Sepay:
-
Tự động xác nhận chuyển khoản
-
Giảm công việc kế toán
-
Tránh sai sót khi đối soát
-
Khách thanh toán nhanh hơn
Câu hỏi thường gặp
SePay là dịch vụ hỗ trợ tự động xác nhận thanh toán chuyển khoản ngân hàng bằng cách đọc nội dung giao dịch và gửi thông báo về hệ thống website hoặc phần mềm quản lý. Nhờ đó doanh nghiệp có thể tự động cập nhật trạng thái thanh toán mà không cần kiểm tra thủ công.
SePay kết nối với tài khoản ngân hàng của bạn và theo dõi các giao dịch chuyển khoản. Khi có giao dịch mới, hệ thống sẽ kiểm tra nội dung chuyển khoản và gửi Webhook/API về website hoặc phần mềm để xác nhận thanh toán cho đơn hàng hoặc hóa đơn tương ứng.
Có. Cá nhân, hộ kinh doanh hoặc doanh nghiệp đều có thể sử dụng SePay nếu có:
Tài khoản ngân hàng hỗ trợ
Website hoặc hệ thống quản lý đơn hàng
Nội dung chuyển khoản theo định dạng quy định
SePay hỗ trợ nhiều ngân hàng tại Việt Nam thông qua các dịch vụ API và kết nối trung gian. Các ngân hàng phổ biến như VPbank, MBBank, TPbank, Sacombank, MSB, ACB… đều có thể tích hợp tùy theo phương thức kết nối. Chi tiết tại: https://my.sepay.vn/bankaccount/connect
SePay có thể tích hợp với nhiều nền tảng như:
Website bán hàng
Hệ thống thương mại điện tử
Phần mềm CRM
Phần mềm quản lý đơn hàng
Ví dụ như Perfex CRM, WooCommerce hoặc các hệ thống tự phát triển thông qua API.
Không. Khách hàng chỉ cần chuyển khoản ngân hàng thông thường với đúng nội dung thanh toán. SePay sẽ tự động đọc nội dung giao dịch để xác nhận thanh toán.
Trong hầu hết trường hợp, hệ thống có thể xác nhận thanh toán gần như ngay lập tức (real-time) sau khi ngân hàng ghi nhận giao dịch. Tuy nhiên thời gian có thể chậm hơn vài phút tùy vào tốc độ cập nhật của ngân hàng.
SePay sử dụng các phương thức bảo mật như:
API Key xác thực
Webhook Secret
Mã hóa dữ liệu khi truyền tải
Ngoài ra hệ thống chỉ đọc thông tin giao dịch, không có quyền thực hiện giao dịch từ tài khoản ngân hàng của người dùng.
Nếu bạn sử dụng các module tích hợp sẵn cho CMS hoặc CRM thì việc cài đặt khá đơn giản và không cần lập trình nhiều. Tuy nhiên với các hệ thống tự phát triển, lập trình viên có thể sử dụng API của SePay để tích hợp.
Có. Sau khi phát hiện giao dịch hợp lệ, SePay sẽ gửi thông báo đến hệ thống của bạn để:
Xác nhận thanh toán
Cập nhật trạng thái đơn hàng
Đánh dấu hóa đơn đã thanh toán
Điều này giúp doanh nghiệp tự động hóa quy trình xử lý thanh toán và giảm sai sót khi đối soát giao dịch.