Website - ZaloPay Gateway

INTEGRATED GUIDE

Giá trị	Ghi chú
MerchantSite	Merchant's web/app.
MerchantServer	Merchant's back-end.
ZaloPayGateway	ZaloPay Gateway's website.
ZaloPayServer	ZaloPay's back-end.

1. Select payment model#

2. Send a request to create order#

2.1. Theo cấu trúc mới#

bank_code	preferred_payment_method	Nội dung truyền thông tin	Kết quả hiển thị trên trang cổng thanh toán	Ghi chú
Rỗng ("")	[]	"bank_code": "", "embed_data": {"preferred_payment_method": []}	Danh sách tất cả các hình thức và ngân hàng được hỗ trợ (ATM, CC, ZaloPay, ZaloPay QR đa năng, Apple Pay ...)	Hình ảnh mô tả 1
Rỗng ("")	["domestic_card", "account"]	"bank_code": "", "embed_data": {"preferred_payment_method": ["domestic_card", "account"]}	Danh sách tất cả Ngân hàng hỗ trợ, người dùng chọn và nhập thông tin thẻ ATM hoặc tài khoản Ngân hàng tương ứng	Hình ảnh mô tả 2
Rỗng ("")	["zalopay_wallet"]	"bank_code": "", "embed_data": {"preferred_payment_method": ["zalopay_wallet"]}	Hiển thị ZaloPay QR code để thanh toán bằng Zalo/ZaloPay	Hình ảnh mô tả 3
Rỗng ("")	["vietqr"]	"bank_code": "", "embed_data": {"preferred_payment_method": ["vietqr"]}	Hiển thị ZaloPay QR đa năng để thanh toán bằng các ứng dụng Ngân hàng và Zalo/ZaloPay	Hình ảnh mô tả 4
Rỗng ("")	["international_card"]	"bank_code": "", "embed_data": {"preferred_payment_method": ["international_card"]}	Form hiển thị cho việc nhập thông tin thẻ tín dụng	Hình ảnh mô tả 5
Rỗng ("")	["applepay"]	"bank_code": "", "embed_data": {"preferred_payment_method": ["applepay"]}	Form hiển thị cho việc chọn phương thức Apple Pay	Hình ảnh mô tả 6
Mã ngân hàng ATM (VTB, VCB, ...)	[]	"bank_code": "specific bank code", "embed_data": {"preferred_payment_method": []}	Form nhập thông tin thẻ của ngân hàng tương ứng Merchant sử dụng API Getlistmerchantbanks để lấy giá trị specific bankcode. (**) Use API to get list of all ZaloPay supported banks here	Hình ảnh mô tả 7

2.1.1 Hình ảnh mô tả 1#

2.1.2 Hình ảnh mô tả 2#

2.1.3 Hình ảnh mô tả 3#

2.1.4 Hình ảnh mô tả 4#

2.1.5 Hình ảnh mô tả 5#

2.1.6 Hình ảnh mô tả 6#

2.1.7 Hình ảnh mô tả 7#

Ví dụ (Tạo đơn hàng thanh toán bằng VietQR)#

• Request

    {
      "app_id": 2553,
      "app_user": "ZaloPayDemo",
      "app_time": 1692808549757,
      "amount": 10000,
      "app_trans_id": "230823_1692808549757",
      "bank_code": "",
      "embed_data": "{\"preferred_payment_method\":[\"vietqr\"]}",
      "item": "[]",
      "callback_url": "https://example.com/zalopay-callback",
      "description": "ZaloPayDemo - Thanh toán cho đơn hàng #230823_1692808549757",
      "mac": "e5f54209e13398f9c0889c663bda7ec8a424c826a41750c787ec34b8e0becc73"
    }
Copied

• Response

    {
      "return_code": 1,
      "return_message": "Giao dịch thành công",
      "sub_return_code": 1,
      "sub_return_message": "Giao dịch thành công",
      "zp_trans_token": "ACyQpbxesWOnY1cCq-ThZHww",
      "order_url": "https://qcgateway.zalopay.vn/openinapp?order=eyJ6cHRyYW5zdG9rZW4iOiJBQ3lRcGJ4ZXNXT25ZMWNDcS1UaFpId3ciLCJhcHBpZCI6MjU1M30=",
      "order_token": "ACyQpbxesWOnY1cCq-ThZHww",
      "qr_code": "00020101021226520010vn.zalopay0203001010618000503173851346261102069938620010A00000072701320006970454011899ZP23235O000007950208QRIBFTTA5204739953037045405100005802VN622108173851346261102069963044149"
    }
Copied

2.2. Theo cấu trúc cũ#

bank_code	Results are displayed on the ZaloPay Gateway page
Empty ("") (*)	List of payment methods and banks supported (CC, ATM, zalopayapp, ...)
zalopayapp	QR code to scan with ZaloPay App
CC	Form to input credit card information
ATM bank code (VTB, VCB, ...)	Form to input bank card information

Ví dụ (Tạo đơn hàng thanh toán bằng Thẻ ATM trên ZaloPay Gateway)#

• Request

    {
      "app_id": 2553,
      "app_user": "ZaloPayDemo",
      "app_time": 1692811526592,
      "amount": 10000,
      "app_trans_id": "230824_1692811526592",
      "bank_code": "",
      "embed_data": "{\"bankgroup\":\"ATM\"}",
      "item": "[]",
      "callback_url": "https://example.com/zalopay-callback",
      "description": "ZaloPayDemo - Thanh toán cho đơn hàng #230824_1692811526592",
      "mac": "058d31a95d891821a58fb0577707ac614dd30d47f45e397c9e1cf9789ceda014"
    }
Copied

• Response

    {
      "return_code": 1,
      "return_message": "Giao dịch thành công",
      "sub_return_code": 1,
      "sub_return_message": "Giao dịch thành công",
      "zp_trans_token": "ACajRfciufEJ5JBMWk8-wlOQ",
      "order_url": "https://qcgateway.zalopay.vn/openinapp?order=eyJ6cHRyYW5zdG9rZW4iOiJBQ2FqUmZjaXVmRUo1SkJNV2s4LXdsT1EiLCJhcHBpZCI6MjU1M30=",
      "order_token": "ACajRfciufEJ5JBMWk8-wlOQ"
    }
Copied

3. Redirect to ZaloPay Gateway#

4. Checking order status#

5. Handle callback from ZaloPay Server#

6. ZaloPay Gateway redirect to Merchant Site#