常见问题解答

本页提供有关 Google Pay API 的一般信息和常见问题解答。

Google Pay API 简介

Google Pay 可让用户在您的应用和网站内轻松结算。借助 Google Pay API，您的客户可以使用保存在其 Google 账号中的卡在您的应用和网站中进行顺畅结算。

如何获得支持

在 Google Pay & Wallet Console 中注册，然后选择“与支持团队联系”。我们可以帮助您排查集成问题。此外，您可以参阅我们的 Android 问题排查指南和 Web 问题排查指南，自行调试您的集成。

支持的功能

Google Pay API 支持多项功能。

支持的付款方式

Google Pay API 可能会返回卡或网络令牌。

定期结算和订阅

对定期结算的支持与 Google Pay API 响应中返回的付款方式紧密相关。令牌化的卡和存入的卡都可用于定期结算。要处理定期结算，商家无需按一定频率调用我们的 API。相反，付款凭据会存储在商家端，用于定期付款。商家可使用其支付网关 API 来管理定期结算。

如果以下陈述属实，Google Pay 即会支持定期付款：

商家遵守网络规则，例如由商家发起的交易。
商家的购买流程中披露了付款条款，并且用户接受这些条款。

我们还支持金额可变的定期结算。例如，支持适用于移动运营商的月度手机账单。如需了解详情，商家必须与其支付网关代表联系。

自动充值或“充值”

要完成自动充入等额费用的操作，商家不必每次都调用我们的 API。付款凭据会存储在商家一端，并重复使用。如需了解详情，商家必须与其支付网关代表联系。

退款

商家可以按照他们目前针对其他付款方式处理退款的方式处理涉及取消、赔偿或争议的交易撤消。如需了解详情，商家必须与其处理方代表联系。

捐款筹集

经批准的公益组织 (NPO) 可以集成 Google Pay API 来筹集捐款，前提是他们必须提供文件来证明、证实和验证其公益组织身份例如，美国公益组织必须提供美国国税局出具的有效 501(c)3 资质证明才能获得资格。

条款及政策

Google Pay API 服务条款

所有商家都必须同意并遵守 Google Pay API 服务条款。

Google Pay API 使用限制政策

所有商家都必须同意并遵守 Google Pay API 使用限制政策。

“赌博”政策

我们针对赌博的政策在 Google Pay API 使用限制政策中进行了定义。

我们关于赌博的政策可能会不时发生变化。所有提交的内容都必须经过审核和批准。

我们接受以下国家/地区的公司提供的赌博集成服务：

澳大利亚
加拿大
捷克
法国
格鲁吉亚
德国
希腊
匈牙利
爱尔兰
意大利
日本
荷兰
波兰
葡萄牙
罗马尼亚
西班牙
瑞典
英国

在后期，我们可能会选择将现有的支持范围扩大。

如需获得 Google Pay API 的正式版访问权限以进行博彩集成，您需要完成一系列前提条件：

如果您仅有 Android 赌博集成，且位于上述国家/地区之一，则必须先遵守 Google Play 的赌博政策，并完成 Google Play 的审核流程。然后，我们可以评估您的纯 Android 集成，以确定您是否可以获得 Google Pay API 的正式版访问权限。
如果您仅在上述国家/地区进行基于 Web 的赌博集成，则必须在 Google Pay API 的初始配置流程中提交授权许可，以证明您有资格在该国家/地区提供赌博服务。然后，我们可以评估您的纯 Web 集成是否符合 Google Pay API 的正式版访问权限要求。
如果您在上述国家/地区之一同时集成了 Android 和 Web 赌博功能，则必须先遵守 Google Play 的赌博政策，并完成 Google Play 的审核流程。然后，我们可以评估您的 Android 和 Web 集成，以确定您是否可以获得 Google Pay API 的正式版访问权限。

存在特定条件或限制的国家/地区

如果赌博集成符合以下条件，则允许在所列国家/地区使用：

国家/地区	Android 集成资格要求	网站集成资格要求
保加利亚	是，但有限制：重定向到网站的应用符合条件。禁止使用不重定向到网站的应用。	是
塞浦路斯	是，但有限制：州彩票符合条件。 OPAP Cyprus Limited 符合条件。禁止宣传在线赌场。禁止宣传老虎机。禁止赛马博彩。禁止进行赛狗博彩。禁止差价投注。禁止使用博彩交易平台。	是，但有限制：州彩票符合条件。 OPAP Cyprus Limited 符合条件。禁止宣传在线赌场。禁止宣传老虎机。禁止赛马博彩。禁止进行赛狗博彩。禁止差价投注。禁止使用博彩交易平台。
芬兰	是，但有限制： Veikkaus Oy 符合条件。	是，但有限制： Veikkaus Oy 符合条件。
哈萨克斯坦	是，但有限制：彩票符合条件。体育博彩广告符合条件。总和投注符合条件。禁止宣传在线赌场。禁止宣传电子赌场。	是，但有限制：彩票符合条件。体育博彩广告符合条件。总和投注符合条件。禁止宣传在线赌场。禁止宣传电子赌场。
波兰	否	是，但有限制：获得许可的赌博服务提供商符合条件。
南非	是，但有限制：在线体育博彩符合条件。	是，但有限制：在线体育博彩符合条件。

如果您要将 Google Pay API 扩展到之前未获批准的国家/地区，请与我们联系以获得扩展批准。请注意，您需要为计划提供赌博相关服务的每个国家/地区提供有效的赌博许可。我们不允许将 Google Pay API 用于面向未成年人或当地法律禁止赌博的个人的赌博服务。

医疗保健政策

Google Pay API 使用限制政策中规定了我们的医疗保健政策。

在开始使用时，请准备好分享相关许可，以验证您的医疗保健使用情形。所有提交的内容都必须经过审核和批准。

金融服务政策

Google Pay API 使用限制政策中定义了我们的金融服务政策。

在完成初始配置以验证您的金融服务使用情形时，请准备好提供相关许可。所有提交的内容都必须经过审核和批准。

常规常见问题解答

以下常见问题解答适用于商家：

我通过一家大型 PSP 来管理所有风险和增强型客户身份验证。关于 GPay，我应该了解哪些信息？

Google Pay API 会以签名的加密载荷返回付款方式。返回的付款方式包括 PAN 或由设备 PAN (DPAN) 和密码组成的令牌化卡。

令牌化卡载荷无需额外的步骤或验证即可处理。

包含 PAN 的卡载荷需要通过内部或 PSP 提供的解决方案进行 3D 安全验证。

如果您的 PSP 负责管理所有风险和 SCA 逻辑，请确保您的 Google Pay API 集成包含以下属性：

merchantInfo.merchantName（Android、Web）：商家名称呈现在付款页面中。
transactionInfo.countryCode（Android、Web）：这表示交易的处理位置。您必须指定收单银行所在国家/地区。
transactionInfo.totalPrice（Android、Web）：交易的总货币价值，可以选择在小数点后保留两位小数。

如何获取 Google 商家 ID？

在 Google 批准您的网站后，您即可获得 Google 商家 ID。如需开始此流程，请登录 Google Pay 和钱包控制台并创建 Google Pay API 集成。您需要提供完全限定网域（包括子网域）的列表，以便您调用 Google Pay API。

我们能否在多个品牌和渠道（网站/应用）中使用单个商家 ID？

支持跨多个品牌和平台（例如网站和 Android）使用单个 Merchant ID，并且通常建议这样做，以简化对账。

商家如何在其应用和网站中提升用户对 Google Pay 的接受程度？

如要突出显示对 Google Pay 的支持，请务必使用我们的 Android 和网页品牌推广指南中提供的资源。

如果您有 Android 集成，则可以在 Play 商店说明中注明您现在支持 Google Pay。对于网页集成，您可以直接向商家网站添加说明。

电子商务平台可以支持 Google Pay 吗？

可以，Google Pay API 支持电子商务平台。代表其商家托管结算页面的付款处理方、网关或电子商务平台合作伙伴可以使用 Google Pay 的托管结算功能。

哪些支付服务提供商支持 Google Pay？

如需查找支持 Google Pay 的处理方列表，请查看我们的 Google Pay 处理方列表。

Google Pay 支持哪些国家和地区？

请查看使用 Google Pay 支持在线付款或应用内付款的受支持国家/地区列表。

Google Pay 令牌 (CRYPTOGRAM_3DS) 支持哪些国家和地区？

请参阅我们的寻找支持实体店内购物和感应式购买的付款方式页面，查看支持 Google Pay 令牌的国家/地区列表以及每个国家/地区支持此类令牌 (CRYPTOGRAM_3DS) 的银行。该页面同时列出了受支持和不受支持的卡。

Google Play 应用内结算与 Google Pay API 之间的区别是什么？

在 Android 应用中销售数字商品和服务的 Google Play 开发者必须使用 Google Play 应用内购结算，如 Play 开发者政策中心中所指定。应用内结算的示例包括虚拟游戏商品、应用功能或内容以及云软件产品。请参阅 Google Play 结算服务概览页面，详细了解应用内购买结算。

当用在应用中时，Google Pay API 仅适用于实体商品和服务。

Google Pay 会收取费用吗？

Google Pay 不会因使用 Google Pay API 进行付款而向用户、商家和开发者收取额外费用。需要特别指出的是，商家会继续向其付款处理方支付处理费。

Google 如何验证凭据并防止欺诈？

添加到 Google 的所有卡都会通过验证授权来验证卡详细信息，包括银行卡验证码 (CVC)。Google 还会根据付款方式数据、Google 账号个人资料、交易记录、位置和设备信息运行专有风险引擎。但是，商家必须继续使用当前的欺诈和风险评估工具处理 Google Pay 交易。

移动应用 WebView 是否支持 Google Pay？

Android WebView 完全支持 Google Pay，并模拟移动网站体验，前提是您添加了必要的 WebKit 依赖项。不过，在 iOS WebView 上，由于 iOS 对第三方 Cookie 的限制，isReadyToPay API 将始终返回 false。WebView 中的 Android 应用和网站网域都必须获得正式版访问权限。如需了解具体的实现细节，请参阅使用 Android WebView 或使用 iOS WKWebview 文档。

我的处理器未列出。我还能与 Google Pay 集成吗？

Google Pay 不断与电子商务平台和支付处理方建立合作伙伴关系。如果您在 g.co/pay/processors 中找不到您的处理方，可以提交申请。当处理器可供使用时，您会收到通知。

如果我已有付款处理方或付款平台提供商，如何启用 Google Pay？

Google Pay 可与各种支付服务提供商和电子商务平台提供商搭配使用。每种语言都提供专门的定制文档，可帮助您轻松入门，并提供主要教程，让您轻松上手。

如果我是支持 Google Pay 的支付处理方，如何大规模向我的商家提供 Google Pay？

受支持的付款处理方可以为网页集成实现我们的托管结账解决方案。借助托管的结账流程，您的客户可以向其客户提供 Google Pay，并跳过 Google Pay 的单独注册流程。

首先，您必须完成注册，成为受支持的支付处理机构。如需集成托管结账解决方案，请与帮助您完成初始配置的 Google 技术联系人联系。

如果我在结账流程中提供配送服务，Google Pay 如何适应不同的配送选项和不同的价格？

对于 Web 集成，您需要送货地址，并在 PaymentDataRequest 对象、PaymentOptions 对象和 PaymentDataCallbacks 对象中显示不同的运费选项和价格。如需查看示例情况，请参阅动态价格更新演示。

对于 Android 集成，您需要在 PaymentDataRequest 对象中提供送货地址。

如何收取通过 Google Pay 进行的购买交易的款项？

Google Pay API 通过将付款信息从用户传递给您的支付服务提供商来促成交易。它不属于资金流，旨在与您现有的支付基础设施相辅相成。

获得正式版访问权限需要满足哪些要求？

商家必须在 Google Pay 和钱包控制台中创建商家资料，并上传购买流程的屏幕截图以供审核。托管 Google Pay API 的每个网域都必须单独提交以供审批，因为通配符网域（例如 *.merchant.com）不接受。如需了解详情，请参阅“发布集成”页面（针对 Android 和/或 Web）。

如何了解我的集成提交状态，以及在您审核后是否需要进行任何更改？

提交 Google Pay API 集成以供审核后，您会收到一封包含审核结果的电子邮件。如果您的集成符合我们的《使用政策》和品牌推广指南，则会获得批准，并在 Google Pay & Wallet 控制台中显示为有效状态。如果需要更改，状态会显示为需要更多信息，并且电子邮件会详细说明您需要修正哪些内容才能重新提交。如果您对提交内容有任何疑问，可以直接通过 Google Pay & Wallet Console 联系支持团队。

如果我看到错误消息，该如何排查 Google Pay API 集成方面的问题？

如需了解常见错误代码和解决方案，请参阅我们的 Android 和 Web 问题排查指南。如果您还有其他问题，请通过 Google Pay & Wallet 管理中心与支持团队联系。

如何自定义 Google Pay API 集成以限制卡？

卡片的所有自定义设置都可在 CardParameters 对象中找到，适用于 Android 和 Web。例如，您可以选择要允许哪些卡网络，以及要允许哪些卡发卡机构国家/地区。

什么是 Google Pay API？

借助 Google Pay API，您的客户只需按下按钮即可使用保存在其 Google 账号中的付款方式完成付款。该 API 可为数百万用户提供简单的结账体验，这些用户已保存数亿张卡。它可提高安全性，系统会对客户付款数据进行端到端加密，以将其从 Google 服务器发送到您的付款处理方。集成过程非常简单，可与您现有的付款处理堆栈配合使用，只需几行代码即可实现。

Google Pay API 和 Google Wallet API 有何关联？

Google Pay API 和 Google Wallet API 是两个独立的 API。Google Pay API 可让您的客户在您的网站或 Android 应用中使用 Google Pay 作为付款方式。Google 钱包 API 可让开发者创建和管理各种用例的数字卡券。例如，会员卡、票券、通行证、健康记录和其他可自定义的项目。如需详细了解 Google Wallet API，请访问 Google Wallet API 开发者文档。

当前的 Google Pay API 版本是什么，以及如何处理更新？

当前版本列在 Android 和 Web 文档中。Google 已维护此版本多年，仅添加了新功能和可选字段。对 API 进行的任何更新都具有向后兼容性，以确保当前集成不会中断。

哪些平台支持 DPAN (CRYPTOGRAM_3DS)，哪些平台支持 FPAN (PAN_ONLY)？

DPAN 仅适用于 Android，并且仅在 Android 设备或 Android 移动网站/WebView 上结账时可用。桌面版网页和 iOS 设备不支持 DPAN，默认情况下会返回 PAN_ONLY。

如何区分 DPAN 和 FPAN，以及应如何处理它们？

assuranceDetails 对象旨在帮助商家确定交易是否需要通过 3D Secure 进行增强型客户身份验证 (SCA)，而不是严格区分 DPAN 和 FPAN。如需接收这些详细信息，商家必须在其 Google Pay API 请求中向卡参数添加 assuranceDetailsRequired: true。

cardHolderAuthenticated 和 accountVerified 有何区别？

如果请求中将 assuranceDetailsRequired 设置为 true，则响应将包含两个属性：

accountVerified：表示用于付款的卡是正品，并且相应账号状态良好。不过，仅凭此验证无法提供授权保护。
cardHolderAuthenticated：表示用户是使用其 Android 设备开始交易，并使用了预配的基于设备的网络令牌。

我们如何使用这些标志来触发 3D Secure？

商家应使用这些标志来构建其 3D Secure 触发逻辑。如果 cardHolderAuthenticated 和 accountVerified 都返回 true，则表示相应凭据非常安全且符合 SCA 标准，您无需升级交易以进行进一步的 3DS 身份验证。

如果商家设置了 assuranceDetailsRequired: true，是否会收到电子商务令牌？

否，电子商务令牌是在 PSP 级层控制的。

Google Pay 交易是否符合责任转移条件？

责任转移功能是否可用取决于支付卡网络。MasterCard 会自动为符合条件的令牌交易提供此服务，而 Visa 要求商家通过 Google Pay 控制台手动选择启用此服务。如需了解详情，请参阅启用 Visa Liability Shift。

我们如何识别“先买后付”(BNPL) 交易？

目前，没有针对 BNPL 交易的特定标识符。它们将以常规 FPAN 凭据的形式显示在您的系统中。

Google 能否提供测试卡来测试 SCA 场景？

Google Pay API 无法直接提供任何 SCA 测试卡。您的支付服务提供商 (PSP) 应该能够在沙盒环境中使用其测试卡套件来满足您的测试需求。

加密支付凭据的失效时间或存留时间 (TTL) 是多少？

加密的 Google Pay 载荷的有效期为整整一周。处理延迟授权或异步处理的商家必须确保在载荷过期之前，通过其支付服务提供商 (PSP) 授权付款。

如何处理退款和重新授权等购买后操作？

Google Pay 不参与资金流，仅作为令牌化凭证的直通渠道。初始交易发生后，您的支付服务提供商 (PSP) 会将加密载荷中的付款信息映射到其专有令牌（例如“商家令牌”或“客户资料 ID”）。所有购买后互动和资金流动均完全由您和您的 PSP 管理。