本页列出了 Google Pay API for Android 各版本的主要变更。版本说明按日期排序和标识，并包含变更说明。
2026 年 3 月
- 扩展了网关测试卡，以支持来自 27 个市场的账单邮寄地址（之前仅限美国）。这样，商家就可以在
TEST环境中测试具有特定国家/地区账单邮寄地址的端到端付款流程。新增的市场包括英国、法国、德国、西班牙、日本、香港、巴西以及其他 20 个国家/地区。
2025 年 11 月
- 为
BillingAddressParameters对象的format属性添加了FULL-ISO3166选项，并为ShippingAddressParameters对象引入了新的format属性。更新了IntermediateAddress和Address对象的返回属性，以包含新的格式属性。iso3166AdministrativeArea。此更改不应破坏现有实现。如需了解详情，请查看参考页面。
2025 年 10 月
Play 服务钱包库的版本 19.5.0 将最低 SDK 版本设置为 23，并包含内部依赖项更新。
- 添加了新的 CONTINUE_TO_REVIEW
checkoutOption。使用此选项时，付款表单按钮的标签为“查看订单”。如需了解详情，请查看对象参考文档。
- 为 Pay Button API 新增了对 `PIX` 和 `EWALLET` 按钮类型的支持
- 添加了新的 API 方法 getPaymentMetdata，用于提取与用户首选支付方式相关的元数据，以提升其结账前体验。如需详细了解此功能，请与我们联系。
2024 年 7 月
PayButton API 现在提供了一项个性化功能，可在以下 Google Pay 付款按钮上显示用户的银行卡网络（例如 Visa、Mastercard）和银行卡的后四位数：
| 按钮类型 | 之前 | 之后 |
| 购买 |  |
 |
| PAY |  |
|
此增强功能仅适用于已将支持的银行卡关联到 Google Pay 账号的用户。
2024 年 5 月
Play 服务 Wallet 库的版本 19.4.0 将最低 SDK 版本设置为 21，并包含内部依赖项更新。
2024 年 2 月
发布了 Play 服务 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 &Wallet Console中注册来申请正式版发布权限。
- 在如何获取帮助和问题排查中添加了相关说明，介绍了如何使用 Google Pay &Wallet Console就新手入门和技术问题与支持团队联系。
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) 的信息。