指南
状态页面Dashboard预约演示
开始键入搜索...

直接集成

本页提供使用 Direct 集成连接 Google Pay™ 并将其作为客户支付选项的说明。

要求

在开始 Google Pay 集成过程之前，请确保 Google Pay 在您所在的国家/地区可用。使用Google Pay 支持页面验证对您所在国家/地区的支持。

然后，查看谷歌网站上的参与处理器，检查哪些处理器可用。

所有商户必须遵守谷歌支付应用程序接口可接受使用政策，接受谷歌支付应用程序接口服务条款，并在谷歌支付业务控制台注册以获得谷歌商户 ID。按照以下步骤完成 Google Pay 和钱包控制台的配置：

  1. 填写企业简介

  2. 查看Google Pay API>与网站整合中的所需信息：

    • 您的网站 - 这必须与您托管的结账页面的域名完全一致（带或不带 "www"）。
    • 集成类型 - GATEWAY

  3. 截图

  • 付款方式屏幕 - 您的托管结账页面
  • Google Pay API 支付界面 - Google Pay 支付页面（点击 GPay 按钮后显示）
  • 购买后屏幕 - 交易确认页面
  • 提交截图，说明您已提交申请，并共享商户编号 (BCR)

使用指定的商家 ID 在 Yuno 面板中配置 Google Pay 连接。

整合

要将 Google Pay 与 Yuno 整合，请按照以下步骤操作：

  1. 在Yuno 面板中，转到 "连接 "选项卡。找到 Google Pay 并点击连接。在侧边栏输入您的凭据。为连接选择一个名称，并在商家 ID 字段中使用从Google Pay 业务控制台获取的商家 ID。
  1. 在 Yuno 的控制面板中使用 Google Pay 支付所需的处理器创建路由。更多信息，请参阅配置动态路由指南。

客户将能够选择Google Pay，并通过熟悉的Google Pay界面授权支付。Yuno随后将安全处理从Googletoken ，通过您配置的支付处理器完成交易。所有Google Pay交易都将与其他支付方式一同显示在您的Yuno仪表盘中，便于统一管理，为您提供业务运营的整体视图。

使用 Yuno 启用并测试 Google Pay

集成后，您可以按以下步骤启用和测试 Yuno 的 Google Pay：

  1. 创建 Google 钱包测试账户：
    • 访问Google 钱包测试账户登录页面。
    • 如果您没有 Google 帐户，请先创建一个帐户。
    • 登录后，您将被重定向到 Google 钱包业务控制台。
  2. 访问 Google 钱包 API 部分：
    • 在 Google 钱包业务控制台中，导航至 API 管理或集成部分（通常在开发人员或集成设置下）。
  3. 选择 创建通行证 以便 演示模式:
    • 在 Google 钱包 API 部分，找到标有 "创建通行证 "的选项。
    • 单击此选项可启用演示模式。这样就可以在没有真实交易的情况下模拟和测试通行证的创建和交互。
  1. 从 Play Store 下载Google 钱包应用程序。
  2. 通过支付流程测试集成。

通过以下步骤，您可以确保在向客户提供 Google Pay 之前，Google Pay 已集成并按预期运行。

开始直播

在测试环境中完成所有集成步骤后，请申请Google 生产访问权限并联系您的技术客户经理。Yuno 团队将帮助验证您的配置，并确认您已做好上线准备。

实施细节

将 Google Pay 与 Yuno 整合的关键细节：

谷歌支付应用程序接口授权方法

Yuno 支持两种 Google Pay API 授权方法：

  • PAN_ONLY:存储在用户 Google 账户中的卡凭证。使用时，Yuno 会自动处理 3D Secure 身份验证（如果已启用）。
  • CRYPTOGRAM_3DS:基于设备的卡凭证，内置身份验证功能。这些凭证包括加密验证，不需要额外的 3DS 处理。

这两种方法在 Yuno 开展业务的所有国家和地区均受全球支持。在前端，同时包含 PAN_ONLY 和 CRYPTOGRAM_3DS 在你的 allowedAuthMethods 阵列，以实现最高的付款成功率。

  • 3D Secure（3DS）用于PAN_ONLY 凭证:如果 Google Pay 返回一个 PAN_ONLY 如果启用了 3DS，Yuno 将自动处理 3D Secure 身份验证流程。在前端，确保您的 Google Pay API 请求包括 PAN_ONLY 在 allowedAuthMethods 阵列
  • Gateway 和 GatewayMerchantID 配置:注册时 谷歌支付业务控制台确保 谷歌支付应用程序接口 > 与您的网站整合，"...... 集成类型 设置为 GATEWAY.......。 Merchant ID 在 Yuno 面板中设置 Google Pay 连接时，"商户 ID "字段将使用 Google Pay 业务控制台中的 "商户 ID"。设置 gateway 至 yuno 并使用指定的商家 ID 作为 gatewayMerchantId 在 Google Pay API 配置中。
  • 授权方法：Yuno 支持标准授权方法（购买、授权、捕获）。可用性取决于每个国家的支付处理器和收单银行以及支付方式。
  • 账单地址要求:如果您的支付处理需要客户的账单地址（如 AVS 支票），请在 Google Pay API 请求中进行配置。谷歌提供 BillingAddressParameters 指定所需的详细信息（如 MIN 或 FULL）。参见 谷歌文档.只有在必要时才要求提供账单地址详情，因为这可能会增加结账时的摩擦。
  • 交易数据和支付加密：商家将 Yuno 的 SDK（Android、iOS、Web）集成到自己的应用程序中。当客户选择 Google Pay 时，Yuno 的 SDK 将与 Google Pay API 交互，并安全地从 Google 接收加密支付数据（支付token）。该token 从您的应用程序传递到您的后端服务器，然后使用 Yuno 的服务器端 API 提交token 进行支付处理。Yuno 与支付处理器一起处理解密和处理过程。

其他信息

有关集成过程的更多问题，请联系 Yuno 支持或咨询：

Google 提供品牌指南，帮助您在网站或应用程序中加入 Google Pay 品牌：

支持的卡网络

全球支持的银行卡网络有 AMEX、DISCOVER、JCB、MASTERCARD 和 VISA。巴西支持的网络有 VISA、ELECTRON、MASTERCARD、MAESTRO、ELO 和 ELO_DEBIT。

在请求中传递 Google Pay 支付token

使用 Google Pay 发起交易时，系统会返回一个包含加密支付数据的支付token 。在 payment_method.detail.wallet.payment_token 字段作为支付请求中的 JSON 字符串。

谷歌支付钱包响应对象

Google Pay SDK 返回以下对象结构，必须将其作为完整的 payment_token 价值：

{
  "signature": "MEQCIBvkZdkroLuBAj0K0yhqF4RfvkcWM8hW4nInpGnbSbqHAiA4emX0LkHkdnYqIiGgAQ+gF2Md5ac1DIsHItwJfwj9DQ==",
  "intermediateSigningKey": {
    "signedKey": "{\"keyValue\":\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEZ8tVNZqE1G6292tV11Ff1Pc1xZDZU9Mj5QSqDaU9hMjaH+CYI7+XL+Cor0X+4r0jICgcZgQkS/q+WzY8Eku1Fg==\",\"keyExpiration\":\"1766083480615\"}",
    "signatures": [
      "MEYCIQC75wFVZ3JkWTZenVvU9WVdWzeKUvTiB2FAGtUjIP6qFgIhAP3nB97NF+2lXsqpflH/livwpy24IPSfWMF7i1pHqrw1"
    ]
  },
  "protocolVersion": "ECv2",
  "signedMessage": "{\n  \"encryptedMessage\": \"Fvw/m1KNUIAXRRd6gbbuH2eWEhARKpQL/WZBJF5GCWE9QTuJf15pJUASEIjooQa36AwbGuSUs5qtm36x/yWe8pGi4w2vNyN+bUcnw4HuxrhrPMD+VoioLwmJenHU7/ypW5wzGfOmaCWn3FQ8GjE59mfFtC+8+LPmt3Z9xcvr/wT4Qm09TNRp3k/4/6JaV2+OTYqeOER6pAvqb7WEEjRLjIapvAYKPE6VXrhIo5zdwGh2VWvxY000nkzEIbn3OKShJ/mT7ITLQF9b5J4caGGRVFBn2oobaO72I8CCpiTAWgsw3GnyQACk9ggqnXOugVWinFDDazcs0q2YF3x6fBjz8sJpODx1dTUPrOacvFzEJ9XPovYooYK3wDiRfrtwqoadG/SYlESoguIuuAx+XOdc1jP+NWy0WDVKIqAJOwsg5qkSvNS2qi3m7SKapX3EVLiw/619l9JpTIRHdiIIeOu5BtFYL86o4yb0plrE8/ivvQ2/7U4ISGxzaJ4o6PFk7RZ96nWafdT0m30JlxMmTOI6iUOtsw02SVtinwS+83xcN3s6XRAPWRjJ0d1kaUd/4kHbPy8S/UKNBjanytDwDzn6wEccluisI4E=\",\n  \"ephemeralPublicKey\": \"BPUzeogQZAp0N4D3vLYrvQ7Hc+fc261ZW17LIoMnIAgcWaANAhM39Z8mDCYxpiNIO/F0WtOkJhcvVZFSnI/yq/w=\",\n  \"tag\": \"owzrWByO1bNLbw9m/G2kzGmWDnBCs7QoMN+N0zovZAo=\"\n}"
}

Request 示例

{
  "account_id": "d34257e7-55d4-44cf-8b90-3a5152bbe020",
  "description": "Google Pay test",
  "merchant_order_id": "MER01",
  "country": "US",
  "amount": {
    "currency": "USD",
    "value": 1
  },
  "customer_payer": {
    "email": "[email protected]"
  },
  "workflow": "DIRECT",
  "payment_method": {
    "detail": {
      "wallet": {
        "payment_token": "{\"signature\":\"MEQCIBvkZdkroLuBAj0K0yhqF4RfvkcWM8hW4nInpGnbSbqHAiA4emX0LkHkdnYqIiGgAQ+gF2Md5ac1DIsHItwJfwj9DQ\\u003d\\u003d\",\"intermediateSigningKey\":{\"signedKey\":\"{\\\"keyValue\\\":\\\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEZ8tVNZqE1G6292tV11Ff1Pc1xZDZU9Mj5QSqDaU9hMjaH+CYI7+XL+Cor0X+4r0jICgcZgQkS/q+WzY8Eku1Fg\\\\u003d\\\\u003d\\\",\\\"keyExpiration\\\":\\\"1766083480615\\\"}\",\"signatures\":[\"MEYCIQC75wFVZ3JkWTZenVvU9WVdWzeKUvTiB2FAGtUjIP6qFgIhAP3nB97NF+2lXsqpflH/livwpy24IPSfWMF7i1pHqrw1\"]},\"protocolVersion\":\"ECv2\",\"signedMessage\":\"{\\\"encryptedMessage\\\":\\\"Fvw/m1KNUIAXRRd6gbbuH2eWEhARKpQL/WZBJF5GCWE9QTuJf15pJUASEIjooQa36AwbGuSUs5qtm36x/yWe8pGi4w2vNyN+bUcnw4HuxrhrPMD+VoioLwmJenHU7/ypW5wzGfOmaCWn3FQ8GjE59mfFtC+8+LPmt3Z9xcvr/wT4Qm09TNRp3k/4/6JaV2+OTYqeOER6pAvqb7WEEjRLjIapvAYKPE6VXrhIo5zdwGh2VWvxY000nkzEIbn3OKShJ/mT7ITLQF9b5J4caGGRVFBn2oobaO72I8CCpiTAWgsw3GnyQACk9ggqnXOugVWinFDDazcs0q2YF3x6fBjz8sJpODx1dTUPrOacvFzEJ9XPovYooYK3wDiRfrtwqoadG/SYlESoguIuuAx+XOdc1jP+NWy0WDVKIqAJOwsg5qkSvNS2qi3m7SKapX3EVLiw/619l9JpTIRHdiIIeOu5BtFYL86o4yb0plrE8/ivvQ2/7U4ISGxzaJ4o6PFk7RZ96nWafdT0m30JlxMmTOI6iUOtsw02SVtinwS+83xcN3s6XRAPWRjJ0d1kaUd/4kHbPy8S/UKNBjanytDwDzn6wEccluisI4E\\\\u003d\\\",\\\"ephemeralPublicKey\\\":\\\"BPUzeogQZAp0N4D3vLYrvQ7Hc+fc261ZW17LIoMnIAgcWaANAhM39Z8mDCYxpiNIO/F0WtOkJhcvVZFSnI/yq/w\\\\u003d\\\",\\\"tag\\\":\\\"owzrWByO1bNLbw9m/G2kzGmWDnBCs7QoMN+N0zovZAo\\\\u003d\\\"}\"}"
      }
    },
    "type": "GOOGLE_PAY"
  }
}

约 1 个月前已更新