Bắt đầu quy trình chuyển hướng

Bạn có thể bắt đầu chuyển hướng thanh toán theo hai cách khác nhau:

  1. Khi người dùng chọn "Chuyển hướng thanh toán", họ sẽ được chuyển hướng đến trang web của nhà tích hợp để chọn Hình thức thanh toán (FOP) để sử dụng. Trong phần này trường hợp, noFopChosen sẽ được điền vào yêu cầu. Khi điều này xảy ra, đối tác tích hợp sẽ hiển thị cho người dùng danh sách các nhà phát hành hiện có. Một lần người dùng chọn một trong các thẻ này, thì người dùng sẽ được chuyển tiếp đến trang web/ứng dụng để hoàn tất giao dịch mua hàng.

  2. Người dùng sẽ chọn một phương thức thanh toán (công ty phát hành) trong quy trình mua. Trong trường hợp này, Google sẽ điền issuerId trong yêu cầu và chuyển hướng người dùng đến đối tác tích hợp. Khi nhận được thông báo này, họ sẽ ngay lập tức chuyển hướng người dùng đến trang web/ứng dụng của công ty phát hành để hoàn tất giao dịch mua.

Trong cả hai trường hợp trên, Google sẽ chuyển hướng người dùng trực tiếp đến trang web của nhà tích hợp mà không có bất kỳ lệnh gọi từ máy chủ đến máy chủ nào trước đó từ Google.

Đối tác tích hợp phải triển khai giao thức HTTPS bằng phương thức GET. Các tham số GET, nêu trong Thông số yêu cầu chuyển hướng, sẽ chứa thông tin về khoản thanh toán chuyển hướng được yêu cầu.

Trình tích hợp phải hỗ trợ độ dài URL 2.048 ký tự. Điều này bao gồm lược đồ, máy chủ lưu trữ, cổng, đường dẫn và tham số. Tất cả thông số sẽ được mã hoá UTF-8 trước khi được mã hoá URL.

Yêu cầu chuyển hướng

Dưới đây là ví dụ về URL mà người dùng sẽ được chuyển hướng đến Bắt đầu quy trình Chuyển hướng (còn được gọi là yêu cầu chuyển hướng):

https://www.integratordomain.com/example/redirectEndpoint?callbackUrl=https%3A%2F%2Fexample.google.com%2Freturn%2Furl%3FredirectRequestId%3DcmVxdWVzdDE&redirectRequest=VEhJU19JU19BTl9FTkNSWVBURURfUkVESVJFQ1RfUkVRVUVTVF9QQVlMT0FEX0VYQU1QTEVfVEhBVF9JU19FTkNPREVEX1dJVEhfYmFzZTY0X1VSTC1TQUZFX0VOQ09ESU5H

Giá trị đã giải mã URL của tham số callbackUrl trong ví dụ này là:

https://example.google.com/return/url?redirectRequestId=cmVxdWVzdDE

Tham số redirectRequest được mã hoá và ký bằng PGP hoặc JWE+JWS trước khi được mã hoá base64url.

Các tham số của yêu cầu chuyển hướng

Yêu cầu HTTPS GET phải có các tham số truy vấn sau:

Trường
callbackUrl string

URL để chuyển hướng người dùng đến khi thanh toán hoàn tất. Giá trị này được mã hoá URL và có độ dài tối đa là 512 ký tự.

URL này sẽ bao gồm requestId từ mã hoá redirectRequest trong redirectRequestId GET . Nhà cung cấp phải xác thực rằng redirectRequestId từ callbackUrl và requestId trong tải trọng đã mã hoá sẽ giống với xác minh rằng cả hai đều có liên quan với nhau.

redirectRequest RedirectRequest

BẮT BUỘC: RedirectRequest phải được mã hoá và ký bằng PGP hoặc JWE+JWS. Ngoài ra, giá trị này phải an toàn trên web base64 đã mã hoá.