Bắt đầu
Quy trình tích hợp
(Click vào icon để xem chi tiết)
A. Trải nghiệm với ZaloPay
I. Tải ứng dụng ZaloPay Sandbox
- Dùng thiết bị thật (Real device) để cài đặt ứng dụng ZaloPay Sandbox
- Tài khoản đăng nhập để sử dụng ZaloPay Sandbox phải là Tài khoản đã đăng ký sử dụng Zalo
- Người sử dụng sau khi cài đặt ZaloPay Sandbox, cần phải định danh bằng chức năng định danh trên ứng dụng mới sử dụng được cho việc thử nghiệm thanh toán
II. Nạp tiền vào tài khoản ZaloPay Sandbox
III. Hướng dẫn sử dụng ví ZaloPay Sandbox
A. Đăng ký sử dụng
Bước 1: Mở ứng dụng ZaloPay sandbox và chọn "Đăng nhập với Zalo" hoặc "Đăng nhập với SĐT"
Bước 2: Nhập số điện thoại và chọn "Tiếp tục"
Lưu ý: Mỗi số điện thoại chỉ được sử dụng cho 1 tài khoản ZaloPay sandbox
Bước 3: Nhập mã xác thực (mặc định 111111) được gửi đến số điện thoại vừa nhập
Bước 4: Tạo mật khẩu thanh toán ZaloPay sandbox
Nhập lại mật khẩu lần nữa để xác nhận Chọn "Liên kết ngay" để liên kết với tài khoản Zalo (nếu Đăng nhập với SĐT) Hoàn tất đăng ký và bắt đầu sử dụng
B. Thực hiện thanh toán
Thanh toán mã QR
Bước 1: Mở ZaloPay và chọn “Quét Mã QR”
Bước 2: Quét mã QR
- Mã QR : Quét mã QR show trên Web hoặc máy POS
Bước 3: Xác nhận và hoàn tất giao dịch
Thanh toán Quickpay
Bước 1: Mở ZaloPay sandbox và chọn "Mã Thanh Toán"
Bước 2: Quét mã thanh toán trên màn hình điện thoại
Bước 3: Xác nhận và hoàn tất giao dịch
IV. Thông tin thẻ ngân hàng - sử dụng cho việc test tích hợp Cổng ZaloPay
1. Thông tin thẻ Visa, Master, JCB
| Số thẻ | 4111111111111111 |
| Tên | NGUYEN VAN A |
| Ngày hết hạn | 01/25 |
| Mã CVV | 123 |
2. Danh sách thẻ ATM (test với bank SBI)
2.1. Thẻ hợp lệ
| STT | Số thẻ | Tên chủ thẻ | Ngày phát hành |
|---|---|---|---|
| 1 | 9704540000000062 | NGUYEN VAN A | 1018 |
| 2 | 9704540000000070 | NGUYEN VAN A | 1018 |
| 3 | 9704540000000088 | NGUYEN VAN A | 1018 |
| 4 | 9704540000000096 | NGUYEN VAN A | 1018 |
| 5 | 9704541000000094 | NGUYEN VAN A | 1018 |
| 6 | 9704541000000078 | NGUYEN VAN A | 1018 |
2.2. Thẻ bị mất/đánh cắp
| STT | Số thẻ | Tên chủ thẻ | Ngày phát hành |
|---|---|---|---|
| 1 | 9704540000000013 | NGUYEN VAN A | 1018 |
| 2 | 9704540000000021 | NGUYEN VAN A | 1018 |
| 3 | 9704541000000029 | NGUYEN VAN A | 1018 |
| 4 | 9704541000000052 | NGUYEN VAN A | 1018 |
| 5 | 9704541000000060 | NGUYEN VAN A | 1018 |
| 6 | 9704541000000086 | NGUYEN VAN A | 1018 |
2.3. Thẻ bị timeout
| STT | Số thẻ | Tên chủ thẻ | Ngày phát hành |
|---|---|---|---|
| 1 | 9704540000000039 | NGUYEN VAN A | 1018 |
| 2 | 9704541000000037 | NGUYEN VAN A | 1018 |
| 3 | 9704540000000054 | NGUYEN VAN A | 1018 |
2.4. Thẻ hết tiền
| STT | Số thẻ | Tên chủ thẻ | Ngày phát hành |
|---|---|---|---|
| 1 | 9704540000000047 | NGUYEN VAN A | 1018 |
| 2 | 9704541000000011 | NGUYEN VAN A | 1018 |
| 3 | 9704541000000045 | NGUYEN VAN A | 1018 |
V. Trải nghiệm thanh toán
- Trải nghiệm thanh toán bằng mã QR Code
- Trải nghiệm thanh toáng bằng Cổng ZaloPay - Hỗ trợ thanh toán Ví/ATM/VISA/JCB/Master Card
- Trải nghiệm thanh toán QuickPay - Thanh toán bằng "Mã thanh toán" trên ZaloPay App
VI. Thông tin tích hợp Merchant dùng thử
Để thuận tiện cho việc tích hợp, bạn có thể dùng thông tin dưới đây để trải nghiệm mà không cần phải đăng ký ngay. Trong trường hợp bạn đã chắc chắn về việc tích hợp vui lòng xem hướng dẫn đăng ký ở mục B
AppID và key tích hợp Sandbox
| Appid | 2554 |
| Key1 | sdngKKJmqEMzvh5QQcdD2A9XBSKUNaYn |
| Key2 | trMrHtvjo6myautxDUiAcYsVtaeQ8nhf |
B. Tích hợp môi trường Sandbox
I. Đăng ký tài khoản môi trường Sandbox
Vui lòng cung cấp số điện và email vào nhóm chat hỗ trợ để chúng tôi tiến hành tạo tài khoản sandbox
II. Lấy thông tin tích hợp, thiết lập callback, redirect
Đăng nhập vào https://sbmc.zalopay.vn/ , vào menu Chào, [Số điện thoại] Quản lý app tích hợp để lấy thông tin appid, keys được cấp cũng như thiết lập callback url, redirect url (trường hợp tích hợp Cổng ZaloPay, Mobile Web To App)
III. Xem tài liệu và tiến hành tích hợp
Xem tài liệu các mô hình tích hợp đã chọn
- Danh sách API
- Mô hình Thanh toán qua Cổng ZaloPay - Phù hợp cho Web
- Mô hình App To App
- Mô hình Thanh toán QRCode - Phù hợp cho máy POS
- Mô hình QuickPay
- Mô hình Web in App
- Mô hình QRCode tĩnh tại quầy
- Mô hình Mobile Web To App
Thực hiện đầy đủ các chức năng sau đây:
Chủ động truy vấn trạng thái thanh toán của đơn hàng khi trong trường hợp chưa nhận được callback
Xử lý redirect (trường hợp tích hợp Cổng ZaloPay, Mobile Web To App)
IV. QC ZaloPay kiểm tra kết quả tích hợp
Sau khi Merchant hoàn tất việc tích hợp và unit test, gởi ứng dụng (web link, application installation package) cho QC ZaloPay kiểm tra kết quả
C. Triển khai môi trường Production
- Merchant đăng ký tài khoản real tại https://mc.zalopay.vn/user-register
- ZaloPay duyệt và cấp appid, keys môi trường production
- QC ZaloPay kiểm tra lại giao dịch trên môi trường production
- Ký biên bản nghiệm thu và Go Live