Giới thiệu

Tính năng Dịch vụ thanh toán trong Admin giúp bạn thêm, cấu hình và quản lý các cổng/phương thức thanh toán đang sử dụng trên website (ví dụ: PAY2S, PAYPAL, SEPAY, VNPAY…). Tại đây, Admin có thể:
  • Quản lý danh sách dịch vụ thanh toán đang có (xem nhanh trạng thái, loại tiền, độ ưu tiên…)
  • Cập nhật cấu hình tích hợp (ngân hàng, đường dẫn API, đường dẫn gọi lại/callback…)
  • Thiết lập khóa máy khách / khóa bí mật phục vụ xác thực
  • Cấu hình cài đặt chung liên quan thông báo thanh toán

Hướng dẫn sử dụng

Truy cập khu vực quản lý dịch vụ thanh toán

1.png
Trên menu Admin, vào: EzyPayment → Các dịch vụ thanh toán .Tại đây hiển thị danh sách các dịch vụ thanh toán đã được tạo trong hệ thống.
Trong mục Quản lý danh sách “Các dịch vụ thanh toán”, Admin có thể dùng ô Tìm kiếm ở góc phải để lọc nhanh theo mã/tên dịch vụ; bảng danh sách thường hiển thị các cột Logo, Mã, Tên, Loại tiền, Độ ưu tiên, Trạng thái (Chưa kích hoạt/Đã lưu trữ…), Cập nhật lúc và Các hành động; để thao tác nhanh, nhấn icon mắt (Xem) để xem chi tiết cấu hình dịch vụ hoặc icon bút (Sửa) để chỉnh sửa dịch vụ.

Xem chi tiết dịch vụ thanh toán

2.png
Từ danh sách Các dịch vụ thanh toán, nhấn icon mắt (Xem) để mở trang Chi tiết dịch vụ thanh toán, nơi hiển thị đầy đủ các thông tin như: Id/Mã/Tên/Phiên bản, Ngân hàng – Loại tiền – Độ ưu tiên, Logo – Băng rôn, Đường dẫn dịch vụ – Đường dẫn API, Đường dẫn gọi lại (Callback) (có cả path và URL đầy đủ), Các kiểu dáng/Các kịch bản (nếu có), Khóa máy khách/Khóa bí mật (được ẩn ký tự), Trạng thái, cùng thời gian Tạo lúc/Cập nhật lúc; nếu cần thay đổi cấu hình, nhấn Sửa ngay trên màn hình chi tiết.

Thêm mới / chỉnh sửa dịch vụ thanh toán

3.png
Vào giao diện Sửa dịch vụ thanh toán (từ icon bút hoặc nút Sửa) và cấu hình:
Thông tin cơ bản
  • Mã: mã định danh của dịch vụ (thường dùng cho mapping hệ thống, không nên đổi tùy tiện)
  • Tên (*): tên hiển thị của dịch vụ
  • Phiên bản: dùng để ghi chú phiên bản tích hợp (nếu cần)
  • Logo / Băng rôn: chọn ảnh bằng nút Duyệt
Thiết lập nghiệp vụ thanh toán
  • Ngân hàng: chọn ngân hàng (áp dụng với dịch vụ có liên quan)
  • Loại tiền: chọn loại tiền (ví dụ: VND)
  • Độ ưu tiên: số dùng để sắp xếp (ưu tiên cao thường hiển thị trước tùy website)
Cấu hình đường dẫn tích hợp
  • Đường dẫn dịch vụ: URL/đường dẫn liên quan cổng thanh toán (nếu dùng)
  • Đường dẫn API dịch vụ: endpoint API (nếu dùng)
  • Đường dẫn gọi lại (*): path callback của hệ thống (ví dụ dạng /payment/verify/<MA>)
📌 Lưu ý quan trọng về Callback
  • Đường dẫn gọi lại phải đúng chuẩn hệ thống yêu cầu.
  • Màn hình thường hiển thị URL đầy đủ (domain + path) để bạn copy cung cấp cho đối tác thanh toán.
  • Callback phải truy cập được từ Internet (không bị chặn tường lửa nếu chạy thực tế).
Tùy chọn nâng cao
  • Các kiểu dáng: dùng khi muốn cấu hình kiểu hiển thị/format đặc thù
  • Các kịch bản: dùng khi hệ thống cần cấu hình flow theo tình huống
Khóa xác thực
  • Khóa máy khách
  • Khóa bí mật
  • Bạn có thể nhấn nút Ngẫu nhiên để hệ thống tự sinh khóa.
✅ Sau khi chỉnh xong, nhấn Lưu để cập nhật.

Quản lý “Cài đặt” của module EzyPayment

4.png
Để quản lý Cài đặt của module EzyPayment, truy cập EzyPayment → Cài đặt, tại đây bạn có thể cấu hình Tiền tố thông báo thanh toán (dùng để tạo/định danh thông báo thanh toán trong hệ thống, ví dụ YMS) và nhấn Lưu để áp dụng; sau khi thêm/chỉnh sửa cấu hình, hãy quay lại Các dịch vụ thanh toán để kiểm tra Trạng thái, xác nhận đường dẫn gọi lại (callback) đúng và truy cập được, đồng thời thực hiện một giao dịch test (nếu môi trường hỗ trợ) để đảm bảo hệ thống nhận callback và xác thực thanh toán thành công.

Lưu ý quan trọng

✔ Không chia sẻ khóa máy khách/khóa bí mật ra bên ngoài.
✔ Nếu đổi callback/khóa, cần cập nhật lại trên phía cổng thanh toán (đối tác).
✔ Đảm bảo Loại tiền khớp với cấu hình đơn hàng/checkout để tránh lỗi thanh toán.
✔ Khi không dùng dịch vụ, nên chuyển Trạng thái về chế độ phù hợp (ví dụ: lưu trữ/chưa kích hoạt) để tránh hiển thị hoặc phát sinh giao dịch ngoài ý muốn.