Nhà tích hợp phải triển khai một dịch vụ lưu trữ web để chuyển hướng người dùng đến mục đích nạp tiền. Nạp tiền này là một phương thức khác, nhưng có cùng mục đích với việc nạp tiền do Nạp tiền trên Android cung cấp. Nhà cung cấp dịch vụ lưu trữ web này phải có trang web thân thiện với thiết bị di động.
Nhà cung cấp dịch vụ lưu trữ web phải xác định yêu cầu web dành cho thiết bị di động và yêu cầu web dành cho máy tính dựa trên giá trị tiêu đề tác nhân người dùng. Trang được phân phối theo yêu cầu trên web dành cho thiết bị di động phải thân thiện với web dành cho thiết bị di động trên Android và iOS. Ngoài giá trị tiêu đề tác nhân người dùng, ứng dụng sẽ không cung cấp cho bạn gợi ý nào khác về môi trường mà người dùng này đang đưa ra yêu cầu (máy tính để bàn hoặc web).
Máy chủ phải triển khai giao thức HTTPS bằng phương thức GET. Nhà tích hợp sẽ xác định đường dẫn và máy chủ lưu trữ. Trình tích hợp phải hỗ trợ độ dài URL 2.048 ký tự. Các dữ liệu này bao gồm giao thứ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 mã hoá URL.
Yêu cầu
Khi có yêu cầu, Google cung cấp các tham số URL sau đây:
| Các trường | |
|---|---|
gspMajorVersion
|
int
Số phiên bản lớn của yêu cầu này. |
gspTopUpRequest
|
TopUpRedirectRequest
Yêu cầu nạp tiền. |
gspAssociationId
|
string
Chứa giá trị nhận dạng mà trình tích hợp sử dụng để tra cứu thông tin xác thực cho tài khoản mà người dùng đang nạp tiền. Đây là mã liên kết được gửi trong quá trình liên kết tài khoản trong LinkedAccountRequest. |
gspCallbackUrl
|
string
URL mà người dùng sẽ được chuyển hướng đến nhằm hoàn tất quy trình nạp tiền trên Google. Giá trị này là URL được mã hoá. |
Phản hồi
Sau khi hoàn tất quá trình nạp tiền, người dùng phải được chuyển hướng đến gspCallbackUrl bằng HTTPS GET. URL này phải có các tham số truy vấn sau:
| Các trường | |||||||
|---|---|---|---|---|---|---|---|
gspResult
|
int
|
||||||
| redirectRequestId |
string BẮT BUỘC: requestId được gửi trong yêu cầu thanh toán chuyển hướng ban đầu/bắt đầu yêu cầu chuyển hướng. Google sẽ xác minh rằng URL này khớp với requestId đã gửi. Quy trình Chuyển hướng hoàn chỉnh sẽ không thành công nếu không khớp.
|
||||||
gspTopUpResponse |
BẮT BUỘC: TopUpRedirectResponse phải được mã hoá và ký bằng PGP hoặc JWE+JWS. Ngoài ra, giá trị này phải được mã hoá base64 an toàn trên web. |
||||||