Giới Thiệu
Checkout SDK là hệ thống quản lý quá trình thanh toán của nền tảng Zalo Mini App
Đối tượng áp dụng
Để đảm bảo trải nghiệm nhất quán cũng như bảo vệ người dùng tránh khỏi các rủi ro liên quan tới thanh toán, Zalo Mini App Platform (Nền tảng) yêu cầu tất cả các đối tác tham gia phát triển ứng dụng có tính năng thanh toán phải tích hợp Checkout SDK để đảm bảo 2 điều kiện:
- Tất cả các phương thức thanh toán phải được khai báo trên hệ thống. Nền tảng giữ vai trò hiển thị các phương thức thanh toán cho người dùng lựa chọn.
- Tất cả các giao dịch phát sinh trên Nền tảng đều phải được người dùng xác nhận và hệ thống ghi nhận dữ liệu.
Các phương thức thanh toán không đúng quy định hoặc các giao dịch liên quan tới sản phẩm trái với quy định của nền tảng, của pháp luật đều sẽ bị xử lý theo các chính sách tương ứng. Chi tiết xem tại đây
Giải pháp tích hợp
Để sử dụng Checkout SDK, đối tác có thể lựa chọn 1 trong 2 giải pháp tích hợp dưới đây:
Giải pháp 1: Tích Hợp Toàn Diện
Mô tả: Đối tác khai báo thông tin các kênh thanh toán, hệ thống sẽ đứng vai trò trung gian, xử lý giao dịch với các Payment Provider tương ứng và trả về kết quả đối tác.
Điều kiện áp dụng: Mini App của Đối tác có tính năng Thanh toán.
Lợi ích:
- Tiết kiệm nguồn lực: Không tốn quá nhiều thời gian và công sức để tích hợp thanh toán. Nền tảng đã có sẵn luồng kỹ thuật tích hợp thanh toán với đối tác thanh toán.
- Kết nối phương thức thanh toán có sẵn: Checkout SDK đã kết nối và tích hợp sẵn về mặt kỹ thuật các phương thức thanh toán như Zalopay, Momo, VNPay,…
Các bước xử lý:
- Khai báo phương thức thanh toán (bao gồm cả các Secret Key do Payment Provider cung cấp).
- Sử dụng SDK khởi tạo đơn hàng.
- Nhận kết quả trên Mini App.
- Xử lý kết quả thanh toán phía Server.
Hình 1: Minh họa User flow khi Tích hợp toàn diện
Giải pháp 2: Tích Hợp Tuỳ chỉnh
Mô tả: Đối tác khai báo phương thức thanh toán, hệ thống hỗ trợ hiển thị các phương thức thanh toán cho người dùng lựa chọn khi người dùng có nhu cầu thay đổi phương thức thanh toán, sau đó đối tác tự xử lý giao dịch và khai báo kết quả giao dịch với hệ thống.
Điều kiện áp dụng: Chỉ áp dụng cho một số đối tác nhất định, cần kiểm duyệt từ nền tảng.
Đối tượng: phù hợp với đối tác đã có sẵn luồng thanh toán.
Lợi ích:
- Tích hợp nhanh chóng: so với giải pháp 1, giải pháp 2 đã được thiết kế đơn giản và tiện lợi, giúp các đối tác đã có sẵn luồng thanh toán dễ dàng tích hợp vào hệ thống mà không gặp trở ngại.
- Không ảnh hưởng đến người dùng: tích hợp liền mạch và không gián đoạn, người dùng vẫn có thể trải nghiệm mua sắm và thanh toán như bình thường. Chỉ hiển thị UI chọn phương thức thanh toán của Checkout SDK khi người dùng có nhu cầu thay đổi phương thức thanh toán.
- Thống nhất trải nghiệm trên nền tảng: giải pháp 2 được thiết kế để đem lại việc trải nghiệm nhất quán về lựa chọn phương thức thanh toán cho toàn bộ Mini App trên nền tảng.
- Sub-info: nền tảng hỗ trợ hiển thị thêm các thông tin trên UI của phương thức thanh toán, giúp đối tác thể hiện rõ thông tin của từng phương thức.
Các bước xử lý:
- Khai báo phương thức thanh toán (không yêu cầu các thông tin về Secret Key do Payment Provider cung cấp)
- Hiển thị phương thức thanh toán: Sử dụng SDK gọi API để hiện thị giao diện lựa chọn phương thức thanh toán khi người dùng có nhu cầu thay đổi phương thức thanh toán.
- Khởi tạo đơn hàng: Sử dụng SDK gọi API yêu c ầu thanh toán để khai báo thông tin với hệ thống khi phát sinh giao dịch. Sau khi nền tảng xác nhận thông tin giao dịch và trả về thành công, sau đó đối tác sẽ tự xử lý luồng thanh toán với các Payment Provider. (Lưu ý: Ở bước này nền tảng sẽ có luồng hiển thị xác nhận thanh toán với người dùng, người dùng đồng ý sau đó đối tác mới xử lý bước tiếp theo).
- Xử lý kết quả thanh toán phía Server.
Hình 2: Minh họa User flow khi Tích hợp tuỳ chỉnh