本页列出了 Google Pay API for Android 各版本的主要变更。版本说明按日期排序和标识,其中包含变更说明。
2025 年 11 月
- 为
BillingAddressParameters对象的format属性添加了FULL-ISO3166选项,并为ShippingAddressParameters对象引入了新的format属性。更新了IntermediateAddress和Address对象的返回属性,以包含新的格式属性。iso3166AdministrativeArea。此项更改应该不会对现有实现造成破坏性影响。如需了解详情,请查看参考页面。
2025 年 10 月
Play 服务 Wallet 库的版本 19.5.0 将最低 SDK 版本设置为 23,并包含内部依赖项更新。
- 添加了新的 CONTINUE_TO_REVIEW
checkoutOption。使用此选项时,付款表单按钮的标签为“查看订单”。如需了解详情,请查看对象参考文档。
- 为 Pay Button API 新增了对 `PIX` 和 `EWALLET` 按钮类型的支持
- 添加了新的 API 方法 getPaymentMetdata,用于提取与用户首选付款方式相关的元数据,以提升用户在结账前的体验。如需详细了解此功能,请与我们联系。
2024 年 7 月
PayButton API 现在提供了一项个性化功能,可显示用户的卡网络(例如,Visa、Mastercard)以及银行卡的最后四位数:
| 按钮类型 | 之前 | 之后 |
| 购买 | ![]() |
![]() |
| PAY | ![]() |
![]() |
此增强功能仅适用于已将符合条件的卡关联到 Google Pay 账号的用户。
2024 年 5 月
Play Services Wallet 库的版本 19.4.0 将最低 SDK 版本设置为 21,并包含内部依赖项更新。
2024 年 2 月
发布了 Play Services Wallet 库的 19.3.0 版,该版本通过引入用于处理
loadPaymentData 任务结果的新合约,在 Android 上添加了对新的 Activity Result API 的支持。首先,使用 GetPaymentData 和 GetPaymentDataResult 协定创建 activity 结果启动器,开始使用该 API。
2023 年 12 月
发布了 Play 服务钱包库的 19.3.0-beta01 版,该版本通过引入新合约来处理
loadPaymentData 任务结果,从而在 Android 上添加了对新的 Activity Result API 的支持。首先,使用 GetPaymentData 和 GetPaymentDataResult 协定创建 activity 结果启动器,开始使用该 API。
此版本弃用了 AutoResolveHelper#resolveTask(Task 方法。请改用此版本中引入的新的 Activity Result API 协定。
2023 年 9 月
发布了 Play Services Wallet 库的 19.2.1 版,该版本更新了 PayButton API,以便为 Google Play 服务版本低于 23.21.0 的用户回退到静态按钮资源。
2023 年 6 月
-
- 按钮文字的大小与“GPay”徽标相同。
- 可将按钮边距调整为最小和最大按钮高度。
- 可配置的圆角半径,以匹配您的界面设计。
将 Android 上的 PayButton API 从 Beta 版升级为稳定版,同时包含以下更改:
2023 年 4 月
2023 年 2 月
2021 年 2 月
- 将 AsiaBill、bePaid、ConnexPay、EpicPay、Mixplat、Netopia、PaymentFusion、Pikassa 和 PSCB 添加到了参与的支付处理方列表中。
- 向 UX 最佳实践中的所有示例添加了新的 Google Pay 标记素材资源。
2021 年 1 月
- 将 CardKnox、Cloud9 Payment Gateway (C9PG)、Corefy、Pay.nl 和 ReePay 添加到参与处理方列表中。
- 向品牌推广指南添加了新的 Google Pay 标记素材资源。
2020 年 12 月
- 将 ЮKassa、IMOJE、Modulbank、PayNearMe、QIWI 和 QualPay 添加到了参与合作的处理方列表中。
2020 年 11 月
- 将 AllPayments、CellPoint Mobile、Evopay 和 Primer 添加到了参与的付款处理机构列表中。
- 在 SCA 和 Google Pay API 中添加了有关如何配置 Google Pay API 以符合增强型客户身份验证 (SCA) 要求的说明。
2020 年 10 月
- 将 InPlat、IntellectMoney、Rebilly、TAS Link 和 UAPay 添加到参与的处理方列表中。
- 在付款数据加密技术中添加了相关说明,介绍了如何使用我们的
TEST商家 ID 值通过 TINK 库测试解密。
2020 年 9 月
- 将 Alfa-Bank Ukraine、AsiaPay、Bizzon、Credorax 和 Payload 添加到了参与处理方的列表中。
- 在概览中添加了一个视频,该视频以巴西葡萄牙语介绍了 Google Pay API。
- 在教程中添加了 Kotlin 编程语言的示例代码和示例。
- 在测试卡套件中添加了有关如何在
TEST环境中访问测试卡套件的说明。
2020 年 6 月
- 将 ConcordPay、Payfacto、Radial 添加到了参与的支付处理方列表中。
2020 年 5 月
2020 年 4 月
- 将 FreedomPay、Paymo、Oceanpayment 和 PayU India 添加到了参与的处理方列表中。
2020 年 3 月
- 将 2C2P、Windcave、dLocal 和 Paymentwall 添加到了参与计划的处理方列表中。
- 向教程添加了网关形参值。
- 向
CardParameters请求对象添加了allowedCreditCards属性,以便商家过滤掉信用卡交易以供参考。 - 添加了相关说明,介绍了如何通过在 Google Pay 和钱包控制台中注册来申请正式版访问权限。
- 在如何获取帮助和问题排查中添加了相关说明,介绍了如何使用 Google Pay 和钱包控制台就新手入门和技术问题与支持团队联系。
2020 年 2 月
- 将 PayOnline 添加到了参与处理方的列表中。
2020 年 1 月
2019 年 12 月
2019 年 11 月
2019 年 10 月
- 在
CardParameters请求对象的allowedCardNetworks属性中添加了相关说明,以在参考中启用巴西借记卡和信用卡组合卡支持。
2019 年 9 月
- 将 NCCC、eCard 和 BlueGate (NTTData) 添加到了 参与的处理器列表中。
2019 年 8 月
- 在参与处理方列表中添加了 PayAnyWay、Paragon Payment Solutions 和 Paylane。
- 从示例
MerchantInfo对象中移除了merchantId属性。 - 向教程添加了
CheckoutActivity.java以取代YourActivity.java。 - 向教程添加了
PaymentsUtil.java以取代GooglePay.java。 - 为用户体验最佳实践添加了新的补充图片。
- 添加了有关如何自定义集成以符合增强型客户身份验证 (SCA) 要求的说明。
2019 年 7 月
- 将国泰世华银行、Chase Merchant Services(原 Chase Paymentech)、LogPay、Nuvei、Payler、Paymetric 和 RBS 添加到参与计划的处理方列表中。
2019 年 6 月
- 在参与的支付处理方列表中添加了 CardConnect、eGHL 和 LogPay。
- 向使用示例令牌进行测试添加了各种示例令牌示例。
- 在用户体验最佳实践中添加了更多信息和示例。
- 向教程添加了新的
allowedCardNetworks选项INTERAC。
2019 年 5 月
- 将 Braspag、Ecard、Redsys 和 Worldnet 添加到了参与合作的处理方列表中。
2019 年 4 月
- 将 Computop、MyCheck、Sipay、TPay.com 和 Wirecard 添加到支持的网关列表中。
- 在
PaymentMethod请求对象的type属性中添加了 PayPal 作为受支持的付款方式,以供参考。
2019 年 3 月
- 将 iQmetrix、Portmone 和 Vindicia 添加到了参与的处理器列表中。
2019 年 2 月
- 将 Gestpay、iPay88、MultiCarta、Square 和 WayForPay 添加到了参与的支付处理方列表中。
- 在使用示例令牌进行测试中添加了有关加密和通过
DIRECT集成返回的示例载荷的更多信息。 - 在常见问题解答中添加了常见的产品和问题排查问题及解答。
2019 年 1 月
- 将 Assist、GMO Payment Gateway 和 Moneris 添加到受支持的网关列表中。
添加了以下语言的本地化内容:
- 俄语
- 葡萄牙语(巴西)
- 日语
- 波兰语
- 中文(繁体)
- 在网关表格中添加了参与处理方的示例,并在
TokenizationSpecification请求对象的gatewayMerchantId属性中添加了 参考。
2018 年 12 月
- 为品牌推广指南添加了“通过 Google Pay 购买”资源的阿拉伯语版本。
- 针对
DIRECT集成付款数据加密,添加了有关 ECv2 的信息。ECv2 是一种更新的加密协议,可让商家存储静态的长期 Google 签名密钥,该密钥只需每 10 年更新一次。 - 向 Tink 版本说明添加了有关 Tink 库版本 1.1.0 的 ECv2 载荷支持的信息。
2018 年 11 月
2018 年 10 月
- 在付款数据加密中添加了有关
DIRECT集成的密钥轮替说明。
2018 年 9 月
- 向 GitHub 代码示例添加了有关 APIv2 的信息。
2018 年 8 月
- 在更新到最新版本中添加了有关新版 Google Pay API (APIv2) 的信息。


