适用于 Android 的 Google Pay API 版本说明

此页面跟踪 Google Pay API for Android 的更新。

2026 年 3 月 1 日

功能

扩展了网关测试卡,以支持来自 27 个市场的账单地址(之前仅限美国)。这样,商家就可以在 TEST 环境中使用特定国家/地区的账单邮寄地址测试端到端支付流程。新增的市场包括英国、法国、德国、西班牙、日本、香港、巴西和其他 20 个国家/地区。

2025 年 11 月 1 日

功能

BillingAddressParameters 对象的 format 属性添加了 FULL-ISO3166 选项,并向 ShippingAddressParameters 对象引入了新的 format 属性。更新了 IntermediateAddressAddress 对象的返回属性,以添加新的格式属性 iso3166AdministrativeArea。此更改不会对现有实现造成破坏性影响。如需了解详情,请查看参考页面

2025 年 10 月 1 日

功能

Pay Button API 添加了对新的 PIXEWALLET 按钮类型的支持

功能

添加了新的 CONTINUE_TO_REVIEW checkoutOption。使用此选项时,支付表单按钮的标签为“Review Order”(查看订单)。如需了解详情,请查看对象参考

功能

添加了新的 API 方法 getPaymentMetdata,用于提取与用户首选支付方式相关的元数据,以提升用户在结账前的体验。如需详细了解此功能,请与我们联系

2024 年 7 月 1 日

功能

PayButton API 现在提供了一项个性化功能,可在以下 Google Pay 支付按钮上显示用户的银行卡网络(例如 Visa、Mastercard)以及银行卡的后四位数。此增强功能仅适用于已将支持的银行卡关联到 Google Pay 账号的用户。

2024 年 5 月 1 日

功能

Play 服务钱包库的 19.4.0 版将最低 SDK 版本设置为 21,并包含内部依赖项更新。

2024 年 2 月 1 日

功能

发布了 Play 服务钱包库的 19.3.0 版,该版本通过引入新的协定来处理 loadPaymentData 任务结果,从而在 Android 上添加了对新的 Activity Result API 的支持。如需开始使用该 API,请使用 GetPaymentDataGetPaymentDataResult 协定创建 activity 结果启动器。

2023 年 12 月 1 日

功能

发布了 Play 服务钱包库的 19.3.0-beta01 版,该版本通过引入新的协定来处理 loadPaymentData 任务结果,从而在 Android 上添加了对新的 Activity Result API 的支持。如需开始使用该 API,请使用 GetPaymentDataGetPaymentDataResult 协定创建 activity 结果启动器。此版本还废弃了 AutoResolveHelper#resolveTask(Task<TResult>, Activity, int) 方法。请改用此版本中引入的新 Activity Result API 协定

2023 年 9 月 1 日

功能

发布了 Play 服务钱包库的 19.2.1 版,该版本更新了 PayButton API,以便为 Google Play 服务版本低于 23.21.0 的用户回退到静态按钮资源。

2023 年 6 月 1 日

功能

更新了适用于 Android 的 PayButton API,使其按钮文本与“GPay”徽标的大小相同,按钮边距可调整为最小和最大按钮高度,并且边角半径可配置,以与界面设计保持一致。

2023 年 4 月 1 日

功能

添加了适用于 Android 的 PayButton API,用于生成采用最新 Google Pay 品牌准则样式的 Google Pay 支付按钮。如需了解如何 更新到新的支付按钮,请参阅开发者文档

2023 年 2 月 1 日

变更

添加了网关测试卡,以方便进行端到端测试。商家可以选择其中一张卡,以获取令牌,然后将该令牌发送到处理方的测试环境并接收适当的响应。请参阅测试卡套件文档

2021 年 2 月 1 日

变更

将 AsiaBill、bePaid、ConnexPay、EpicPay、Mixplat、Netopia、PaymentFusion、Pikassa 和 PSCB 添加到了参与的处理方列表中。

变更

将新的 Google Pay 徽标资源添加到了 用户体验最佳实践 中的所有示例。

2021 年 1 月 1 日

变更

将新的 Google Pay 徽标资源添加到了 品牌规范

变更

将 CardKnox、Cloud9 Payment Gateway (C9PG)、Corefy、Pay.nl 和 ReePay 添加到了参与的处理方列表中。

2020 年 12 月 1 日

变更

将 ЮKassa、IMOJE、Modulbank、PayNearMe、QIWI 和 QualPay 添加到了参与的处理方列表中。

2020 年 11 月 1 日

变更

将 AllPayments、CellPoint Mobile、Evopay 和 Primer 添加到了参与的处理方列表中。

变更

SCA 和 Google Pay API 中添加了有关如何配置 Google Pay API 以符合增强型客户身份验证 (SCA) 的说明。

2020 年 10 月 1 日

变更

将 InPlat、IntellectMoney、Rebilly、TAS Link 和 UAPay 添加到了参与的处理方列表中。

变更

付款数据加密中添加了有关如何使用我们的 TEST 商家 ID 值通过 TINK 库测试解密的说明。

2020 年 9 月 1 日

变更

将 Alfa-Bank Ukraine、AsiaPay、Bizzon、Credorax 和 Payload 添加到了参与的处理方列表中。

变更

概览中添加了一个以巴西葡萄牙语介绍 Google Pay API 的视频。

变更

测试卡套件 中添加了有关如何在 TEST 环境中访问我们的测试卡套件的说明。

变更

教程 中添加了 Kotlin 编程语言的示例代码和示例。

2020 年 6 月 1 日

变更

将 ConcordPay、Payfacto 和 Radial 添加到了参与的处理方列表中。

2020 年 5 月 1 日

变更

概览中添加了支付流程图,说明了商家、Google 和付款处理方之间的关系。

变更

将 Kassa 添加到了参与的处理方列表中。

变更

参考 中添加了有关 isReadytoPay 客户端参考的更多信息。

2020 年 4 月 1 日

变更

将 FreedomPay、Paymo、Oceanpayment 和 PayU India 添加到了参与的处理方列表中。

2020 年 3 月 1 日

变更

将 2C2P、Windcave、dLocal 和 Paymentwall 添加到了参与的处理方列表中。

变更

教程中添加了网关参数值。

变更

CardParameters 请求对象添加了 allowedCreditCards 属性,以便商家过滤掉信用卡交易,详见 参考

变更
变更

如何获取帮助问题排查中添加了有关如何使用Google Pay & Wallet Console联系支持团队以获取入职和技术问题的帮助的说明。

2020 年 2 月 1 日

变更

将 PayOnline 添加到了参与的处理方列表中。

2020 年 1 月 1 日

变更

品牌规范中添加了摘要视图。

变更

将 Paygent、Judopay、Paymark、e-SiTef - Software Express 和 noon payments 添加到了参与的处理方列表中。

2019 年 12 月 1 日

变更

概览 中添加了 DIRECT 集成要求。

变更

将 Billing Systems、Spreedly、theMAP 和 APPEX 添加到了参与的处理方列表中。

2019 年 11 月 1 日

变更

将 Tranzzo、MOBI.Money、Suntech 和 Best2Pay 添加到了参与的处理方列表中。

变更

将 OpenCart 添加到了参与的平台列表中。

2019 年 10 月 1 日

变更

Reference 中添加了有关如何在 CardParameters 请求对象的 allowedCardNetworks 属性中启用巴西借记卡和信用卡组合卡支持的说明。

2019 年 9 月 1 日

变更

将 NCCC、eCard 和 BlueGate (NTTData) 添加到了 参与的处理方列表中。

2019 年 8 月 1 日

变更

增强型客户身份验证中添加了有关如何自定义集成以符合 SCA 的说明。

变更

示例 MerchantInfo 对象中移除了 merchantId 属性。

变更

用户体验最佳实践中添加了新的补充图片。

变更

将 PayAnyWay、Paragon Payment Solutions 和 Paylane 添加到了参与的处理方列表中。

变更

更新了 教程,将 CheckoutActivity.java 替换为 YourActivity.java,并将 PaymentsUtil.java 替换为 GooglePay.java

2019 年 7 月 1 日

变更

将 Cathay United Bank、Chase Merchant Services(原 Chase Paymentech)、LogPay、Nuvei、Payler、Paymetric 和 RBS 添加到了参与的处理方列表中。

2019 年 6 月 1 日

变更

测试示例令牌中添加了各种示例令牌示例。

变更

教程中添加了新的 allowedCardNetworks 选项 INTERAC

变更

将 CardConnect、eGHL 和 LogPay 添加到了参与的处理方列表中。

变更

用户体验最佳实践中添加了更多信息和示例。

2019 年 5 月 1 日

变更

将 Braspag、Ecard、Redsys 和 Worldnet 添加到了参与的处理方列表中。

2019 年 4 月 1 日

变更

Reference 中将 PayPal 添加为 PaymentMethod 请求对象的 type 属性中支持的支付方式。

变更

将 Computop、MyCheck、Sipay、TPay.com 和 Wirecard 添加到了受支持的网关列表中。

2019 年 3 月 1 日

变更

将 iQmetrix、Portmone 和 Vindicia 添加到了参与的处理方列表中。

2019 年 2 月 1 日

变更

将 Gestpay、iPay88、MultiCarta、Square 和 WayForPay 添加到了参与的处理方列表中。

变更

测试示例令牌 中添加了有关加密以及通过 DIRECT 集成返回的示例载荷的更多信息。

变更

常见问题解答中添加了常见的产品和问题排查问答。

2019 年 1 月 1 日

变更

添加了以下语言的本地化内容:俄语、葡萄牙语(巴西)、日语、波兰语和中文(繁体)。

变更

网关表 中添加了参与的处理方的示例,并向 TokenizationSpecification 请求对象添加了 gatewayMerchantId 属性,以供 参考

变更

将 Assist、GMO Payment Gateway 和 Moneris 添加到了受支持的网关列表中。

2018 年 12 月 1 日

变更

品牌规范中为“使用 Google Pay 付款”资源添加了阿拉伯语。

变更

在付款数据加密中添加了有关 ECv2 的信息,这是一个更新的加密协议,允许商家存储静态的长期 Google 签名密钥,该密钥只需每 10 年更新一次,适用于 DIRECT 集成到 付款数据加密

Tink 版本说明 中添加了有关 Tink 库 1.1.0 版的 ECv2 载荷支持的信息。

2018 年 11 月 1 日

变更

将 NMI 添加到了 参与的处理方列表中。

变更

品牌规范 中添加了有关 Google Pay 徽标的更多信息。

2018 年 10 月 1 日

变更

付款数据加密 中添加了有关 DIRECT 集成的密钥轮替的说明。

2018 年 9 月 1 日

变更

GitHub 代码示例 中添加了有关 APIv2 的信息。

2018 年 8 月 1 日

变更

更新到最新版本中添加了有关 Google Pay API 新版本 APIv2 的信息。