网络充值 API

集成商必须实现网站主机,以重定向用户以便充值。 此充值是一种不同的模态,但用途与 Android 充值提供的充值方式相同。 此网站托管服务商必须有适合移动设备的网站。

Web 主机必须根据用户代理标头值确定移动网络请求与桌面 Web 请求。通过移动网络请求传送的网页必须在 Android 和 iOS 设备上适合在移动网络上投放。除了用户代理标头值之外,客户端不会就用户发出请求的环境(桌面或网络)提供其他提示。

服务器必须使用 GET 实现 HTTPS 协议。路径和主机由集成商定义。集成商必须支持的网址长度为 2,048 个字符。这包括架构、主机、端口、路径和参数。

所有参数在进行网址编码之前都会先经过 UTF-8 编码。

请求

Google 会根据您的请求提供以下网址作为网址参数:

字段
gspMajorVersion int

此请求的主要版本号。

gspTopUpRequest TopUpRedirectRequest

充值请求。

gspAssociationId string

包含集成商用来查找用户充值帐号凭据的标识符。这是在帐号关联期间在 AssociateAccountRequest 中发送的关联 ID。

gspCallbackUrl string

用户为了在 Google 上完成充值流程而重定向到的网址。此值经过网址编码。

响应

完成充值后,必须使用 HTTPS GET 将用户重定向到 gspCallbackUrl。此网址必须具有以下查询参数:

字段
gspResult int

100
充值成功。
201 用户手动取消了该流程,并且应取消该流程。
202 充值因严重原因而失败,相应流程应取消。

redirectRequestId string

必需:在原始/发起重定向付款请求中发送的 requestId。Google 会验证这是否与发送的 requestId 匹配,如果不匹配,“完整重定向”流程将失败。
gspTopUpResponse RedirectResponse

必需TopUpRedirectResponse 应使用 PGPJWE+JWS 进行加密和签名。此外,此值应采用可在 web 环境中安全使用的 base64 编码。