NAV

Thanh toán ZaloPay QR đa năng

ZaloPay QR đa năng

Hướng dẫn tích hợp thanh toán ZaloPay QR đa năng trên Cổng thanh toán ZaloPay

ZaloPay QR đa năng hiện đã được đưa vào hoạt động tại các hệ thống cửa hàng bán lẻ và dịch vụ lớn trên cả nước, đặc biệt là các chuỗi mua sắm, ăn uống như: Viettel Store, Mykingdom, Decathlon, Coolmate, Lee&Tee, Sukiya, Tous les Jours, KFC, Pepper Lunch, Papa’s Chicken, Bonchon Chicken…

Với sản phẩm kết hợp giữa mã QR của ZaloPay và VietQR này, người dùng sẽ có thể linh hoạt sử dụng ứng dụng ngân hàng bất kỳ hoặc Ví điện tử ZaloPay để quét mã ZaloPay QR đa năng. Trọn bộ quy trình được diễn ra trên cùng một nền tảng đem đến trải nghiệm thông suốt và liền mạch cho khách hàng, vừa giúp hạn chế tối đa sai sót, vừa rút ngắn thời gian giao dịch.

Hướng dẫn tích hợp mở thanh toán ZaloPay QR đa năng

1. Merchant tùy chọn phương thức thanh toán và hiển thị trên hệ thống (Merchant hosted)

1.1. Merchant hiển thị QR động trên hệ thống Website hoặc máy POS

Đối với hình thức này, merchant đang tạo mã ZaloPay QR từ giá trị order_url trong response nhận được khi thực hiện gọi API tạo đơn hàng

    {
        "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": "AC891FMJmh_Ca91Bt6lAYW_Q",
        "order_url": "https://qcgateway.zalopay.vn/openinapp?order=eyJ6cHRyYW5zdG9rZW4iOiJBQzg5MUZNSm1oX0NhOTFCdDZsQVlXX1EiLCJhcHBpZCI6MTI0NzA1fQ==",
        "order_token": "AC891FMJmh_Ca91Bt6lAYW_Q",
        "qr_code": "00020101021226520010vn.zalopay0203001010627000503173658480321823028538580
            010A000000727012800069704540114997916406472530208QRIBFTTA5204739953037045405690005802VN62210817365848032182302856304F9B6"
    }
    
Để hiển thị mã ZaloPay QR đa năng cho người dùng sử dụng ứng dụng ngân hàng thanh toán, merchant cần phải hiệu chỉnh, như bên dưới:
  • Merchant cần update lại việc generator mã QR: thay giá trị order_url bằng giá trị qr_code. Giá trị qr_code được ZaloPay trả về khi Merchant thực hiện gọi tạo đơn hàng qua hệ thống ZaloPay
  • Trường hợp Merchant chưa sắp xếp update việc generator mã QR, ZaloPay sẽ hỗ trợ việc hiển thị mã ZaloPay QR đa năng. Tuy nhiên phần này sẽ có ảnh hưởng đến nếu merchant dùng giá trị order_url cho nhu cầu khác.
    Ví dụ: mở order_url trên trình duyệt ...
  • 1.2. Merchant hiển thị phương thức thanh toán ví ZaloPay trên hệ thống

    1.2.1. Merchant muốn hiển thị hai phương thức thanh toán ví ZaloPay, thanh toán mã ZaloPay QR đa năng bằng ứng dụng ngân hàng

  • Merchant tích hợp theo mô hình Web To App và muốn tách biệt hai phương thức thanh toán ví ZaloPay và mã ZaloPay QR đa năng bằng ứng dụng ngân hàng cho người dùng tùy chọn.
  • Merchant cần phải hiệu chỉnh hệ thống, khi gọi API tạo đơn hàng cần truyền thông tin các tham số bank_code, preferred_payment_method, như bên dưới:
  • Phương thức thanh toán Ví ZaloPay
        // Field bank_code
        "bank_code": "",
        // Field embed_data
        "embed_data":
        {
            "preferred_payment_method": [“zalopay_wallet”]
        }
    
    Phương thức thanh toán mã ZaloPay QR đa năng
        // Field bank_code
        "bank_code": "",
        // Field embed_data
        "embed_data":
        {
            "preferred_payment_method": [“vietqr”]
        }
    
    Trên giao diện máy tính (laptop, desktop)
    Trường hợp user sử dụng máy tính (laptop, desktop) để thực hiện thanh toán, cổng thanh toán ZaloPay sẽ tự động hiển thị mã ZaloPay QR đa năng.
    Trên giao diện thiết bị di động (mobile device)
    Trường hợp user sử dụng thiết bị di động (mobile device), sau khi user chọn phương thức thanh toán, cổng thanh toán ZaloPay sẽ hiển thị giao diện mobile, theo từng giao diện cho phương thức tương ứng.

    1.2.2. Merchant chỉ hiển thị duy nhất thanh toán ví ZaloPay

  • Merchant kết hợp ZaloPay & VietQR (all-in-1)
  • Merchant không cần phải hiệu chỉnh hệ thống, phù hợp với merchant đã tích hợp ZaloPay muốn giảm effort tích hợp thêm VietQR
  • Trên giao diện máy tính (laptop, desktop)
    Trường hợp user sử dụng máy tính (laptop, desktop) để thực hiện thanh toán, cổng thanh toán ZaloPay sẽ tự động hiển thị mã ZaloPay QR đa năng.
    Trên giao diện thiết bị di động (mobile device)
    Trường hợp user sử dụng thiết bị di động (mobile device) để thực hiện thanh toán, cổng thanh toán ZaloPay sẽ hiển thị giao diện mobile, bao gồm 2 option mở Zalo hoặc ZaloPay cho việc thanh toán

    2. Merchant mở Cổng ZaloPay để người dùng thực hiện thanh toán (ZaloPay hosted)

  • Merchant tích hợp theo mô hình Web To App và mở Cổng ZaloPay cho người dùng thực hiện thanh toán.
  • Merchant thực hiện mở order_url trên web browser, Cổng ZaloPay sẽ hiển thị thêm option thanh toán mã ZaloPay QR đa năng để người dùng thanh toán.
  • Không tìm thấy kết quả phù hợp