[Hướng dẫn] Tích hợp cổng ZaloPay vào Website

Đối với người dùng tại Việt Nam, thì cổng thanh toán ZaloPay là một cái tên quá quen thuộc, với số lượng người dùng phổ biến khắp đất nước, cổng ZaloPay đã trở thành một trong những công cụ tích hợp thanh toán mà doanh nghiệp cần phải có trên Website kinh doanh của mình.

Để giúp các doanh nghiệp có thể hiểu rõ hơn về cổng thanh toán ZaloPay, thì ATPWeb đã tổng hợp các thông tin giới thiệu tổng quan, đồng thời Hướng dẫn Tích hợp cổng ZaloPay vào Website trong bài viết sau đây.

XEM THÊM: [Hướng dẫn] Tích hợp thanh toán trực tuyến vào website mới nhất

Giới thiệu tổng quan về ZaloPay

ZaloPay là cổng thanh toán di động được sử dụng phổ biến nhất tại Việt Nam, sở hữu nhiều tính năng độc đáo và giao diện sử dụng vô cùng thân thiện với người dùng. Được xây dựng chuyên biệt để thỏa mãn mọi nhu cầu thanh toán trong cuộc sống và nhu cầu kinh doanh…

• Chuyển tiền và thanh toán ngay trong Zalo: Vừa chat vừa chuyển tiền ngay trong khung chat Zalo. Thanh toán mọi dịch vụ mà không cần tải thêm app.
• Thao tác nhanh chóng và dễ dàng: Các bước thao tác đơn giản, chỉ mất khoảng vài giây để hoàn tất giao dịch.
• Giao dịch hoàn toàn miễn phí: ZaloPay Miễn phí chuyển tiền 24/7, miễn phí các giao dịch thanh toán. (*) Một số giao dịch có thể bị tính phí nếu vượt hạn mức tháng.
• An toàn bảo mật: Đáp ứng các tiêu chuẩn bảo mật quốc tế PCI DSS, tiêu chuẩn bảo mật của Ngân hàng Nhà nước.
• Đa dạng dịch vụ: Hàng trăm dịch vụ tiện ích, hàng ngàn điểm chấp nhận thanh toán trên cả nước.
• Ưu đãi hấp dẫn: Tận hưởng các chương trình khuyến mãi hấp dẫn cho mọi dịch vụ, mọi đối tác trên ZaloPay.

Dịch vụ nổi bật của ZaloPay

• Chuyển tiền – Nhận tiền: Chạm là chuyển tiền miễn phí, 24/7 ngay trong khung chat Zalo.
• Nạp/Mua thẻ điện thoại: Đa dạng nhà mạng, chiết khấu cạnh tranh, nạp trong một chạm.
• Thanh toán hóa đơn: Thanh toán tất cả các loại hóa đơn: Điện, nước, internet… đúng kỳ.
• Mua sắm dễ dàng: Mua sắm online và nhận nhiều khuyến mãi tại các sàn thương mại điện tử lớn.
• Thanh toán tại quầy: Thanh toán trực tiếp tại quầy qua các mã QR vô cùng nhanh chóng, tiện lợi.
• Giải trí thỏa thích: Trải nghiệm kho ứng dụng, trò chơi và phim ảnh hấp dẫn trên nhiều nền tảng.

Tích hợp cổng ZaloPay vào Website

Cổng ZaloPay: Sau khi khách hàng lựa chọn sản phẩm/ dịch vụ tại cửa hàng của Doanh nghiệp và chọn thanh toán bằng thẻ ATM hoặc quốc tế trên web/ mobile web của doanh nghiệp. Hệ thống sẽ thực hiện thanh toán trên ZaloPay Gateway và hiển thị kết quả giao dịch thành công trên web/ mobile web của doanh nghiệp.

Dành cho doanh nghiệp có Web hoặc Mobile web bán hàng/dịch vụ trực tuyến và hỗ trợ thanh toán bằng thẻ.

Các bước tích hợp Cổng ZaloPay cho End-user:

• Bước 1: Chọn hình thức thanh toán
• Bước 2: Gửi yêu cầu tạo đơn hàng
• Bước 3: Redirect đến trang ZaloPay Gateway
• Bước 4: Truy vấn trạng thái đơn hàng
• Bước 5: Xử lý CallBack từ ZaloPay Server
• Bước 6: ZaloPay Gateway chuyển hướng (redirect) về Merchant Site

1. Chọn hình thức thanh toán

Khi End-user thực hiện thao tác thanh toán đơn hàng, giao diện Merchant Site cần hiển thị các hình thức thanh toán của ZaloPay như: Ví ZaloPay, Thẻ Visa/Master/JCB, Thẻ ATM theo một trong các quy cách sau:

• QUY CÁCH 1: Với quy cách này, danh sách ngân hàng sẽ được hiển thị trên giao diện của ZaloPay Gateway ở bước sau

• QUY CÁCH 2: Với quy cách này, danh sách ngân hàng được hiển thị trên giao diện Merchant Site

Tải về:

• Download source HTML (quy cách 1)
• Download source HTML (quy cách 2)

Tiếp theo, End-user bấm nút Thanh Toán để gửi yêu cầu tạo đơn hàng (bước 2)

2. Gửi yêu cầu tạo đơn hàng

Sau khi End-user bấm Thanh Toán, MerchantSite gửi yêu cầu tạo đơn hàng sang MerchantServer. MerchantServer sẽ gọi API tạo đơn hàng của ZaloPayServer.

Lưu ý: Cách sử dụng tham số bankcode trong API tạo đơn hàng, tương ứng với từng tùy chọn hình thức thanh toán

bankcode	Kết quả hiển thị trên trang cổng thanh toán
Rỗng (“”) (*)	Danh sách tất cả các hình thức và ngân hàng được hỗ trợ (CC, ATM, zalopayapp, …)
zalopayapp	Hiển thị QR code để thanh toán bằng ví ZaloPay/ Mở ứng dụng ZaloPay để thanh toán qua ví đối với mobile
CC	Form nhập thông tin Credit Card
Mã ngân hàng ATM (VTB, VCB, …)	Form nhập thông tin thẻ của ngân hàng tương ứng

Chú thích:

• (*) Trong trường hợp Merchant muốn trang cổng thanh toán chỉ hiện thị danh sách các ngân hàng ATM, thì Merchant để bankcode=”” và thêm bankgroup = ATM vào embeddata như ví dụ bên dưới:

{ "returncode": 1, 
"returnmessage": "Thành công", 
"orderurl":"https://sbgateway.zalopay.vn/openinapp?order=eyJ6cHRyYW5zdG9rZW4iOiJ4dGd1SEs1YnU0VDJkSHE3TUFwTFFnIiwiYXBwaWQiOjN9"

 

• (**) Sử dụng API lấy danh sách các ngân hàng được hỗ trợ tại đây

3. Redirect đến trang ZaloPay Gateway

Khi MerchantServer gọi request tạo đơn hàng tới ZaloPayServer (ở bước 2) sẽ nhận được kết quả có chứa giá trị order_url. MerchantSite sử dụng order_url này để redirect người dùng đến cổng thanh toán ZaloPay.

4. Truy vấn trạng thái đơn hàng

15 phút sau khi tạo đơn hàng ở bước 2 (15 phút là thời gian timeout của giao dịch), nếu chưa nhận được thông tin callback, Merchant Server chủ động gửi request đến ZaloPay Server để lấy thông tin trạng thái đơn hàng.

API liên quan: getstatusbyapptransid

Ghi chú:

• API getstatusbyapptransid chỉ có hiệu lực trong vòng 48h kể từ lúc ZaloPay Server ghi nhận đơn hàng.
• API getstatusbyapptransid chỉ có thể sử dụng sau khi hệ thống của Merchant nhận callback hoặc redirect hoặc 15 phút sau khi tạo đơn hàng.

Lưu ý:

• Một đơn hàng chỉ có giá trị trong vòng 15 phút tính từ lúc tạo đơn hàng.
• Khi chưa quá 15 phút tính từ lúc tạo đơn hàng, đối với các trường hợp sau cần lặp lại quá trình gọi API để lấy kết quả cuối cùng:
  • Khi return_code = 3 (Đơn hàng chưa thanh toán hoặc giao dịch đang xử lý)
• Chỉ có thể lấy được trạng thái của đơn hàng trong vòng 48 giờ tính từ lúc tạo đơn hàng, sau 48 giờ sẽ nhận được return_code = 3

5. Xử lý CallBack từ ZaloPay Server

Sau khi End-user hoàn thành các bước thanh toán trên ZaloPay Gateway, nếu trừ tiền user thành công ZaloPayServer sẽ trả về (callback/notify) thông tin trạng thái thanh toán cho MerchantServer theo callback_url lúc đăng ký ứng dụng hoặc giá trị callback_url ở bước tạo đơn hàng (chỉ áp dụng cho tài liệu v2).

API liên quan: callback

6. ZaloPay Gateway chuyển hướng (redirect) về Merchant Site

• Sau khi End-user thanh toán, ZaloPay Server sẽ trả về trạng thái giao dịch cho ZaloPay Gateway.
• ZaloPay Gateway chuyển hướng (redirect) về Merchant Site để hiển thị kết quả giao dịch trên giao diện.

Các bước tích hợp Cổng ZaloPay vào Website cho Doanh nghiệp:

Đăng ký tài khoản doanh nghiệp

Tài liệu cần thiết khi đăng ký

1. Giấy chứng nhận đăng ký doanh nghiệp
2. Giấy phép ngành nghề kinh doanh có điều kiện
3. Giấy đăng ký chi nhánh, địa điểm kinh doanh của các cửa hàng
4. Chứng minh nhân dân, Căn cước công dân của người đại diện doanh nghiệp, hộ kinh doanh, cá nhân kinh doanh
5. Hình ảnh chụp địa điểm kinh doanh, hình ảnh chụp cá nhân kinh doanh, đại diện hộ kinh doanh kinh doanh
6. Chứng từ chứng minh Đơn vị chấp nhận thanh toán sở hữu website/ ứng dụng
7. Chứng từ chứng minh đã thông báo, đăng ký với Bộ công Thương
8. Giấy ủy quyền của người ký

Quy trình đăng ký tài khoản doanh nghiệp ZaloPay

BƯỚC 1 – ĐĂNG KÝ TÀI KHOẢN

Đăng ký tài khoản kinh doanh với các thông tin doanh nghiệp cơ bản. Đồng ý với điều khoản hợp đồng ZaloPay thể hiện khi đăng ký tài khoản.

BƯỚC 2 – CẬP NHẬT CHỨNG TỪ

Tải lên và cập nhật các chứng từ cần thiết: giấy chứng nhận đăng ký doanh nghiệp, mã số thuế, v.v…

BƯỚC 3 – IN QR / NGHIỆM THU

• Với giải pháp QR Tĩnh: Sau khi đăng ký thành công, hệ thống sẽ kiểm tra tính hợp lý của hồ sơ đăng ký và cung cấp QR Tĩnh sau 2 giờ làm việc (giờ hành chính).
• Với giải pháp QR Động hoặc QuickPay: Doanh nghiệp cần tiến hành tích hợp kỹ thuật, ZaloPay sẽ hỗ trợ nghiệm thu sau khi tích hợp thành công.
• Sau khi in QR/Nghiệm thu, Doanh nghiệp có thể triển khai thanh toán bằng nguồn Ví (trong khi chờ thẩm định).

BƯỚC 4 – ZALOPAY THẨM ĐỊNH

Doanh nghiệp in và ký bản Hợp đồng sử dụng dịch vụ, sau đó gửi bản cứng về cho ZaloPay trong vòng 5 ngày làm việc.

Sau khi nhận hợp đồng, bộ phận pháp chế của Zalopay sẽ tiến hành thẩm định hồ sơ doanh nghiệp trong 2 ngày làm việc. Nếu hồ sơ đủ điều kiện, doanh nghiệp sẽ được chấp nhận thanh toán bằng tất cả các kênh thanh toán và hạn mức thanh toán chung của ZaloPay.

Ký hợp đồng với ZaloPay

Để có thể sử dụng cổng thanh toán ZaloPay trước tiên bạn cần liên hệ trực tiếp với ZaloPay để ký kết hợp đồng, thông tin chi tiết bạn có tìm hiểu trực tiếp trên Cổng thanh toán ZaloPay

>> Lưu ý: Khách hàng cần cung cấp link callbackURL và redirectURL cho ZaloPay như sau:

• link callbackURL : https://{alias}.atpweb.vn/zalopay/listener
• link redirectURL : https://{alias}.atpweb.vn/zalopay/paymentResult

Trong đó:

{alias} thay bằng tên site của khách (Ví dụ: abc.atpweb.vn)

Sau khi hợp đồng được hoàn thiện, nhà cung cấp ZaloPay sẽ cung cấp cho bạn các thông tin sau:

• AppId
• Key1
• Key2
• Phương thức xác thực dữ liệu

Có được thông tin cung cấp bạn quay lại trang quản trị website và tiến hành tích hợp cổng thanh toán ZaloPay.

Kích hoạt cổng thanh toán ZaloPay trên website

Bước 1: Tại trang quản trị website, vào Cấu hình và chọn Phương thức thanh toán

Bước 2: Trong phương thức thanh toán bạn tìm đến hình thức thanh toán qua ZaloPay, click vào Thiết lập

Màn hình sẽ hiển thị form điền thông tin kết nối, bạn thực hiện nhập các nội dung vào các ô tương ứng:

Trong đó:

• Tên phương thức thanh toán: Điền tên phương thức thanh toán ZaloPay hoặc một tên gọi khác để khách hàng biết đây là hình thức thanh toán qua ZaloPay
• AppId: ID của app kết nối giữa doanh nghiệp và ZaloPay
• Key1: Mã key kết nối số 1
• Key2: Mã key kết nối số 2
• Phương thức xác thực dữ liệu: Mặc định chọn mã ATZHJSH277, đây là mã do bên ZaloPay cung cấp riêng cho doanh nghiệp.
• Hướng dẫn thanh toán: Nhập nội dung hiển thị ở trang thông báo mua hàng thành công và trang thanh toán

Bước 3: Chọn Lưu để hoàn tất cài đặt.

Kiểm tra đặt hàng và thanh toán

Tích hợp thành công phương thức thanh toán qua ZaloPay bạn tiếp tục tiến hành kiểm tra đặt hàng và thanh toán qua hình thức này để đảm bảo việc tích hợp thành công.

Bước 1: Trước tiên để tiến hành toán toán qua hình thức ZaloPay, bạn sẽ cần cài app ZaloPay trên thiết bị di động.

Tiếp theo truy cập vào website và chọn mua sản phẩm. Tại trang thanh toán đơn hàng, click chọn phương thức thanh toán qua ZaloPay:

Bước 2: Bạn chọn nút Đặt hàng, hệ thống sẽ chuyển sang trang app thanh toán ZaloPay, bạn se bắt đầu quá trình thanh toán theo 3 bước mà ZaloPay hướng dẫn:

• Mở ứng dụng ZaloPay trên điện thoại
• Chọn Thanh toán và quét mã QR code hiển thị trên website
• Hoàn thành các bước thanh toán theo hướng dẫn trên ứng dụng

Plugin Tích hợp ZaloPay vào Website WordPress

Ngoài ra bạn cũng có thể tích hợp cổng ZaloPay vào Website bằng các Plugin hỗ trợ, điển hình nhất là Plugin sau:

Thanh Toán Quét Mã QR – Momo,Zalo Pay,Moca Grab, Shopee Pay

Tích hợp thanh toán quét mã một cách đơn giản nhất:

• Hỗ trợ QR code Momo tự nhập tiền đơn hàng
• Thêm Nút vào APP Momo tự nhập tiền đơn hàng trên Mobile
• Trên Mobile không cần quét mã QR Code. Chỉ cần nhấn nút vào App Momo
• Hỗ trợ QR Momo trong email đơn hàng

Ưu điểm:

• Hỗ trợ hầu hết nền tảng thanh toán như Momo, ZaloPay, GrabMoca, AirPay
• Giao dịch nhanh bật app quét là tiền về
• Không cần có giấy phép kinh doanh, thanh toán hoàn toàn bằng tài khoản cá nhân
• Không tốn phí giao dịch thanh toán
• Thanh toán tiện lợi, nhanh chóng
• Hỗ trợ quét mã trên Desktop và cả Mobile

Nhược điểm: Không thể xử lý giao dịch tự động.

Plugin tích hợp cổng ZaloPay này còn cung cấp thêm hầu hết các ví điện tử tại Việt Nam bao gồm ZaloPay, Air Pay, Moca, Grab, VNPay, Viettel Pay để khách hàng của bạn dễ dàng chuyển khoản cho bạn mà chỉ cần thao tác trong vài giây.

Với việc tích hợp được thanh toán quét mã với hầu hết các ví tại Việt Nam, Plugin này giúp cho tỉ lệ chuyển khoản đơn hàng cao hơn rất nhiều, khắc phục được tình trạng thất thoát các đơn hàng do khách hàng gặp khó khăn trong quá trình thanh toán.

Nguồn: Tổng hợp

ATPWeb hy vọng rằng bài viết trên đã giúp các bạn biết thêm nhiều kiến thức hữu ích và nếu như bạn đang có nhu cầu cài đặt tích hợp thanh toán hoặc các plugin thông minh tương tự cho Website của mình, nhưng vẫn chưa tìm được giải pháp tối ưu nhất thì hãy liên hệ ngay với ATPWeb trong hôm nay để được tư vấn miễn phí nhé!

• Hotline: 0707 6666 56
• Fanpage: http://facebook.com/atpweb.vn
• Website: http://atpweb.vn