Bỏ qua để đến nội dung
RetionRetionTài liệu

Thanh toán qua ZaloPay

I. Giới thiệu chung

Tính năng giúp cửa hàng nhận thanh toán không dùng tiền mặt qua Ví ZaloPay. Khách chọn ZaloPay trên trang thanh toán, thanh toán trong ứng dụng ZaloPay (hoặc Zalo), kết quả được tự động cập nhật vào đơn hàng trên Merchant.

Đối tượng áp dụng: cửa hàng đã có tài khoản ZaloPay Merchant (ZaloPay doanh nghiệp).

Chưa có tài khoản ZaloPay Merchant? Vào mc.zalopay.vn, bấm Đăng ký thành Đối tác (hoặc Trở thành đối tác của chúng tôi) và làm theo hướng dẫn, hoặc gọi hotline ZaloPay 1900 54 54 36.

Trang ZaloPay Merchant, nút Đăng ký thành Đối tác và Truy cập Merchant Tool

Lợi ích:

  • Chủ cửa hàng, quản lý: tự kết nối và quản lý tài khoản ZaloPay, tập trung dòng tiền, đối soát giao dịch tự động.
  • Nhân viên bán hàng: không cần kiểm tra tay, đơn tự chuyển sang đã thanh toán khi khách trả tiền thành công.
  • Khách hàng: thanh toán nhanh bằng ZaloPay ngay trong ứng dụng Zalo quen thuộc.

II. Các thao tác cơ bản

Tóm tắt luồng thao tác:

  1. Lấy khóa tích hợp trên ZaloPay Merchant.
  2. Kết nối tài khoản ZaloPay trên Merchant.
  3. Khách thanh toán và hệ thống nhận kết quả giao dịch.

1. Lấy khóa tích hợp trên ZaloPay Merchant

Để kết nối, bạn cần 3 thông tin: App ID, Key 1 và Key 2.

Bước 1: Đăng nhập Công cụ quản lý ZaloPay Merchant bằng tài khoản chủ doanh nghiệp.

Bước 2: Vào mục Dịch vụ tích hợp, chọn thẻ dịch vụ thanh toán đã đăng ký (ví dụ Web to App hoặc Cổng thanh toán).

Bước 3: Bấm Lấy khóa tích hợp, nhập mật khẩu tài khoản để xác nhận, sau đó tải tệp khóa về máy.

Bước 4: Mở email đăng ký ZaloPay Merchant để lấy mật khẩu giải nén tệp vừa tải. Giải nén tệp, bạn sẽ thấy:

  • App ID (Mã ứng dụng)
  • Key 1 (khóa tạo chữ ký giao dịch)
  • Key 2 (khóa xác thực kết quả ZaloPay gửi về)
  • Khóa dùng cho thử nghiệm (Sandbox) và chính thức là khác nhau. Muốn thử trước khi bán thật, liên hệ ZaloPay để được cấp bộ khóa Sandbox.
  • Không gửi Key 1, Key 2 cho bất kỳ ai qua tin nhắn hay email. Chỉ nhập trực tiếp vào Merchant.

2. Kết nối tài khoản ZaloPay trên Merchant

Chỉ tài khoản có quyền thiết lập thanh toán mới thực hiện được thao tác này.

Bước 1: Đăng nhập Merchant.vn. Tại Sảnh chờ, mở app Đơn hàng.

Sảnh chờ, app Đơn hàng

Bước 2: Bấm biểu tượng bánh răng ở góc dưới bên trái màn hình Đơn hàng.

Biểu tượng cài đặt ở góc dưới bên trái

Bước 3: Chọn Cài đặt Thanh toán.

Menu cài đặt, mục Cài đặt Thanh toán

Bước 4: Tìm thẻ ZaloPay:

  • ZaloPay nằm ở mục Đề xuất (chưa kết nối): bấm Kết nối, rồi bấm Thêm kết nối ở cửa sổ Tài khoản kết nối.
  • ZaloPay nằm ở mục Đã kết nối (đã có tài khoản): bấm Thêm tài khoản để thêm một tài khoản ZaloPay khác.
Cài đặt thanh toán, thẻ Zalopay ở mục Đề xuất
Cửa sổ Tài khoản kết nối, nút Thêm kết nối

Bước 5 – Thông tin kết nối: cửa sổ Thêm kết nối Zalopay mở ra. Nhập 3 thông tin đã lấy ở phần 1 – Lấy khóa tích hợp:

Ô trên Merchant Lấy từ ZaloPay Merchant
ID ứng dụng App ID
Mã bảo mật Key 1
Mật mã webhook Key 2

Bấm Tiếp tục.

Cửa sổ Thêm kết nối Zalopay, bước Thông tin kết nối

Bước 6 – Thiết lập: bật/tắt các tùy chọn:

  • Đang hoạt động: cho phép sử dụng cấu hình này. Nên bật.
  • Tài khoản mặc định: dùng ZaloPay làm phương thức thanh toán mặc định trên web.
  • Hiện trên cổng thanh toán: cho khách chọn ZaloPay khi thanh toán online. Nên bật.
  • Môi trường:
    • Tắt – Chính thức: nhận thanh toán thật. Dùng bộ khóa chính thức.
    • Bật – Sandbox: chỉ thử nghiệm, không nhận thanh toán thật. Dùng bộ khóa Sandbox.

Bấm Kết nối. Nếu thông tin đúng, hệ thống báo Thêm tài khoản Zalopay thành công và ZaloPay chuyển sang mục Đã kết nối.

Môi trường phải khớp với bộ khóa: Chính thức dùng khóa chính thức, Sandbox dùng khóa Sandbox. Nhập lệch sẽ không tạo được giao dịch. Khi chuyển từ Sandbox sang Chính thức, hệ thống sẽ hỏi xác nhận và kiểm tra lại kết nối.

3. Khách thanh toán và nhận kết quả giao dịch

Bước 1: Khi thanh toán đơn hàng, khách mở trang thanh toán và chọn Ví điện tử ZaloPay.

Bước 2: Trang chuyển sang cổng thanh toán ZaloPay. Khách quét mã QR hoặc mở ứng dụng ZaloPay để xác nhận thanh toán.

Bước 3: Thanh toán xong, ZaloPay gửi kết quả về hệ thống. Giao dịch được cập nhật thành công hoặc thất bại, đơn hàng trên Merchant tự cập nhật theo. Khách được đưa trở lại trang của cửa hàng.

Mỗi giao dịch qua ZaloPay tối đa 2.000.000.000đ. Đơn có số tiền lớn hơn sẽ không chọn được ZaloPay trên trang thanh toán.

4. Thay đổi thông tin kết nối

Dùng khi bạn muốn sửa, tạm ngưng, xóa hoặc thêm một tài khoản ZaloPay khác.

Bước 1: Vào Cài đặt Thanh toán, bấm biểu tượng bánh răng (Cấu hình) trên thẻ ZaloPay.

Bước 2: Danh sách Tài khoản kết nối hiện ra. Chọn thao tác:

  • Chỉnh sửa (biểu tượng bút): đổi thông tin kết nối hoặc thiết lập, bấm Lưu. Muốn tạm ngưng thì tắt Đang hoạt động.
  • Thêm kết nối: thêm một tài khoản ZaloPay khác, làm lại từ bước 5 phần 2 – Kết nối tài khoản ZaloPay.
  • Xóa (biểu tượng thùng rác): gỡ tài khoản khỏi cửa hàng. Thao tác này không thể hoàn tác.

III. Lưu ý

  • Cần tài khoản ZaloPay Merchant, ví ZaloPay cá nhân không dùng được.
  • Lấy khóa tích hợp trên ZaloPay Merchant trước khi kết nối. Mật khẩu giải nén tệp khóa được gửi qua email đăng ký.
  • Khóa Sandbox và chính thức khác nhau, phải chọn Môi trường tương ứng khi kết nối.
  • Giữ bí mật Key 1 và Key 2. Nếu nghi bị lộ, tạo lại khóa trên ZaloPay Merchant rồi Chỉnh sửa lại kết nối trên Merchant.
  • Mỗi giao dịch tối đa 2.000.000.000đ.
  • Cần hỗ trợ về tài khoản ZaloPay: hotline 1900 54 54 36.