Hướng dẫn tích hợp module Zalopay cho Perfex CRM
🔑 Thông tin Đăng nhập Demo
Thông tin tích hợp môi trường sandbox:
Hiện tại, để thuận tiện và bảo mật hơn với các hệ thống tích hợp thanh toán qua Zalopay. Quý merchant xin vui lòng chú ý:
1.Tích hợp môi trường Sandbox và Production
Zalopay sẽ gửi thông tin tích hợp (AppID, Key1 (Mac key), Key2 (Callback key)) qua email cho người phụ trách tích hợp.
test thử sandbox:
App ID: 2554
Mac key (key 1): sdngKKJmqEMzvh5QQcdD2A9XBSKUNaYn
Callback key (key 2): trMrHtvjo6myautxDUiAcYsVtaeQ8nhf
2. Danh sách APIs cho việc tích hợp, vui lòng tham khảo
Đơn hàng:
https://docs.zalopay.vn/vi/docs/specs/order
Hoàn tiền:
https://docs.zalopay.vn/vi/docs/specs/refund
Callback (IPN):
https://docs.zalopay.vn/vi/docs/specs/callback
3. Để kiểm tra các đơn hàng ở dưới môi trường sandbox, vui lòng vào tool
https://sbmc.zalopay.vn/home
(chọn Đăng nhập sau đó chọn Quên mật khẩu để reset password với số điện thoại <SĐT mà bạn đăng ký>).
4.Các bước để onboarding trên tạo tài khoản Zalopay trên môi trường sandbox, thực hiện test thanh toán
- Bước 1: Download app tương ứng với device trên môi trường sandbox, vào link:
https://docs.zalopay.vn/vi/docs/developer-tools/test-instructions/test-wallets - Bước 2: Đăng kí tài khoản, OTP mặc định: 111111. Đặt mật khẩu thanh toán trên sandbox: 6 số dễ nhớ.
- Bước 3: Upload CCCD chính chủ, chụp ảnh xác thực
- Bước 4: Nạp tiền vào môi trường test, vào link:
https://docs.zalopay.vn/vi/docs/developer-tools/test-instructions/test-wallets (Phần
nạp tiền nằm phía bên dưới)
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
Hướng dẫn cài đặt vui lòng xem video hướng dẫn để rõ hơn.
- Tải file zip về và giải nén chuyển vào thư mục /modules/
- Vào trang quản lý mục quản lý module để kích hoạt: Ví dụ: https://democrm.scovietnam.com/admin/modules
- Chọn Active / Kích hoạt > Chọn Setup & License (Giấy phép) nhập mã kích hoạt để hoàn thiện việc kích hoạt
- Sau đó chọn Cấu hình gateway. Ví dụ đường dẫn: https://democrm.scovietnam.com/admin/settings?group=payment_gateways
- Vào trang https://mc.zalopay.vn/dashboard để lấy thông tin tích hợp sau đó quay trở lại trang quản lý cấu hình Zalopay để điền thông tin vào.
Hướng dẫn Sử dụng
Khi tạo hóa đơn, hãy chọn Zalopay làm phương thức thanh toán trên hóa đơn mặc định khi thanh toán.
Hướng dẫn quy trình đăng ký và tích hợp cổng thanh toán ZaloPay vào website
1. Điều kiện để đăng ký tích hợp ZaloPay
Để tích hợp cổng thanh toán ZaloPay vào website, doanh nghiệp cần có:
Thông tin pháp lý:
-
Giấy phép đăng ký kinh doanh / hộ kinh doanh
-
CCCD / CMND của người đại diện
-
Tài khoản ngân hàng doanh nghiệp hoặc cá nhân
-
Website hoặc ứng dụng bán hàng
Yêu cầu website:
-
Website có HTTPS (SSL)
-
Có chính sách bán hàng / hoàn tiền
-
Có thông tin liên hệ rõ ràng
2. Quy trình đăng ký Merchant ZaloPay
Bước 1: Đăng ký tài khoản Merchant
Doanh nghiệp đăng ký tài khoản trên hệ thống Merchant của ZaloPay.
Thông tin cần khai:
-
Tên doanh nghiệp
-
Mã số thuế
-
Người đại diện
-
Website bán hàng
-
Tài khoản ngân hàng nhận tiền
Sau khi tạo tài khoản Merchant bằng số điện thoại, hệ thống sẽ tạo hồ sơ đối tác.
Bước 2: Cung cấp hồ sơ xác minh
ZaloPay sẽ yêu cầu các tài liệu:
-
Giấy phép kinh doanh
-
CCCD người đại diện
-
Hình ảnh địa điểm kinh doanh (nếu có)
-
Website đang hoạt động
Sau khi nộp hồ sơ → ZaloPay tiến hành kiểm duyệt.Bước 3: Ký hợp đồng tích hợp
Sau khi được duyệt:
-
ZaloPay gửi hợp đồng hợp tác
-
Merchant ký hợp đồng điện tử
-
Xác nhận tài khoản ngân hàng nhận tiền
Quá trình này hoàn tất sẽ kích hoạt tài khoản Merchant.
3. Quy trình tích hợp kỹ thuật vào website
Sau khi được cấp quyền Merchant, ZaloPay cung cấp:
-
AppID -
Key1 -
Key2 -
API Endpoint
Các thông tin này dùng để kết nối hệ thống.
Luồng thanh toán ZaloPay trên website/ CRM
Quy trình thanh toán thường gồm 6 bước:
Bước 1: Khách chọn ZaloPay
Trên trang checkout website hiển thị các phương thức:
-
Ví ZaloPay
-
Thẻ ATM
-
Visa / MasterCard
Bước 2: Tạo đơn hàng
Website gửi request tới server Merchant để tạo đơn.
Server gọi API Create Order của ZaloPay để tạo giao dịch.
Bước 3: Chuyển sang cổng ZaloPay
Sau khi tạo đơn thành công:
-
ZaloPay trả về
order_url -
Website redirect khách sang trang thanh toán ZaloPay
Bước 4: Khách thực hiện thanh toán
Khách có thể thanh toán bằng:
-
Ví ZaloPay
-
Thẻ ATM nội địa
-
Thẻ quốc tế
Bước 5: ZaloPay gửi Callback
Sau khi thanh toán:
-
ZaloPay gửi callback về server Merchant
-
Merchant xác nhận trạng thái đơn hàng
Bước 6: Chuyển người dùng về website
ZaloPay redirect khách về website để hiển thị:
-
Thanh toán thành công
-
Thanh toán thất bại
Luồng thanh toán gồm:
User ← ZaloPay Gateway ← Merchant Server
4. Các hình thức tích hợp ZaloPay
Có 3 cách phổ biến:
1. Payment Gateway
Thanh toán qua trang ZaloPay.
Phổ biến nhất cho:
-
Website bán hàng
-
WooCommerce
-
Booking system
2. QR Payment
Website hiển thị QR ZaloPay để khách quét thanh toán.
3. Web to App
Dùng cho:
-
Mobile website
-
App mobile
Khi thanh toán → mở trực tiếp app ZaloPay.
5. Thời gian triển khai
Thông thường:
| Giai đoạn | Thời gian |
|---|---|
| Đăng ký Merchant | 1–3 ngày |
| Duyệt hồ sơ | 3–5 ngày |
| Tích hợp API | 1–3 ngày |
| Test & nghiệm thu | 1–2 ngày |
Tổng thời gian trung bình: 5–10 ngày.
6. Lưu ý khi tích hợp ZaloPay
Nên chuẩn bị:
-
Website có SSL
-
Trang Chính sách thanh toán
-
Trang Điều khoản dịch vụ
-
Trang Hoàn tiền
Một số website bị từ chối do:
-
Website chưa hoàn thiện
-
Không có thông tin pháp lý
-
Nội dung không rõ sản phẩm
Câu hỏi thường gặp
ZaloPay là cổng thanh toán trực tuyến cho phép website hoặc ứng dụng nhận tiền từ khách hàng thông qua ví điện tử, thẻ ATM nội địa hoặc thẻ quốc tế. Cổng thanh toán này giúp doanh nghiệp tự động xử lý giao dịch và quản lý thanh toán online.
Có. Cá nhân hoặc hộ kinh doanh vẫn có thể đăng ký tích hợp ZaloPay nếu có:
CCCD / CMND hợp lệ
Tài khoản ngân hàng
Website hoặc nền tảng bán hàng
Trong một số trường hợp, ZaloPay có thể yêu cầu giấy phép hộ kinh doanh để hoàn tất hồ sơ.
Doanh nghiệp cần chuẩn bị các thông tin sau:
Giấy phép đăng ký kinh doanh
Mã số thuế
CCCD người đại diện pháp luật
Website bán hàng
Tài khoản ngân hàng nhận tiền
Sau khi cung cấp đầy đủ hồ sơ, ZaloPay sẽ tiến hành kiểm duyệt.
Thông thường quá trình xét duyệt kéo dài từ 3 đến 7 ngày làm việc, tùy thuộc vào việc hồ sơ đã đầy đủ hay cần bổ sung thêm thông tin.
Website tích hợp ZaloPay nên có:
Đã thông báo website bán hàng/ thương mại điện tử ... với bộ công thương
Chứng chỉ bảo mật SSL (HTTPS)
Trang giới thiệu doanh nghiệp
Chính sách thanh toán và hoàn tiền
Thông tin liên hệ rõ ràng
Những yếu tố này giúp ZaloPay xác minh tính hợp pháp của dịch vụ
Khi tích hợp ZaloPay, khách hàng có thể thanh toán bằng:
Ví điện tử ZaloPay
Thẻ ATM nội địa
Thẻ Visa / MasterCard
Quét mã QR ZaloPay
Điều này giúp tăng tỷ lệ thanh toán thành công cho website.
Phí giao dịch của ZaloPay phụ thuộc vào loại hình kinh doanh và thỏa thuận trong hợp đồng. Thông thường phí dao động khoảng 1% – 2.5% mỗi giao dịch, nhưng có thể thay đổi theo ngành nghề và doanh thu.
Sau khi khách hàng thanh toán thành công, tiền sẽ được ZaloPay tổng hợp và chuyển về tài khoản ngân hàng của doanh nghiệp theo chu kỳ đối soát, thường là T+1 hoặc T+2 ngày làm việc.
Nếu sử dụng các nền tảng phổ biến như WordPress hoặc WooCommerce, bạn có thể cài đặt plugin hỗ trợ ZaloPay mà không cần lập trình nhiều. Tuy nhiên với website tự xây dựng, việc tích hợp sẽ cần sử dụng API do ZaloPay cung cấp. Nếu sử dụng Perfex CRM hãy đặt mua module Zalopay để tích hợp nhanh chóng.
Có. ZaloPay cung cấp cổng quản trị Merchant cho phép doanh nghiệp:
Theo dõi lịch sử giao dịch
Kiểm tra trạng thái thanh toán
Đối soát doanh thu
Xuất báo cáo giao dịch
Nhờ đó doanh nghiệp có thể quản lý thanh toán trực tuyến dễ dàng hơn.