集成 Google Pay 支付

2026-02-10 07:17

通过 Google Pay 服务，买家可以使用存储在其 Google Pay 账户中的信用卡或借记卡进行支付。借助 Antom Checkout Page，您无需额外集成 Google Pay 的 SDK，Checkout Page 将会为您加载 Google Pay 服务，并可将 Google Pay 配置为极速支付方式。

用户体验

Web 端

Mobile 端

集成准备

在您开始集成前，请阅读集成指南及接口概述文档，了解服务端接口的集成步骤及调用接口的注意事项，并确保已完成以下预配置：

已获得 client ID。
已完成密钥配置。
已完成异步通知接收地址的配置。
集成服务端 SDK 资源包，并完成接口库安装及请求示例初始化。具体操作请参阅服务端 SDK。
参阅 Web/WAP 端集成 SDK 资源包文档来集成客户端 SDK 资源包，并注意使用最新或不低于 1.41.0 版本的 SDK。

集成步骤

请按照以下步骤开始集成：

创建支付会话
嵌入至 Antom Checkout Page
获取支付结果
请款

步骤 1：创建支付会话服务端

按照步骤 1：创建支付会话的步骤调用 createPaymentSession（单笔支付）接口并传入订单信息，创建支付会话后跳转至 Antom Checkout Page。同时，您还需要在请求中传入以下参数：

类型	字段	是否必需	描述
订单参数	order.buyer	是	商户端买家信息。至少需要提供以下三者其中一个信息： order.buyer.referenceBuyerId order.buyer.buyerPhoneNo order.buyer.buyerEmail 注意：如果未传入买家信息，买家在选择 Google Pay 为支付方式并提交支付时，页面将出现错误，导致支付流程无法完成。
设置 Google Pay 的相关参数	availablePaymentMethod.paymentMethodMetaData.googlePayConfiguration	否	在 Checkout Page 场景下，该参数建议使用缺省值。注意：您也可以通过设置该参数指定 Google Pay 为收银台中唯一支付方式，详情参见指定支付方式。
指定 Google Pay 为极速支付方式	availablePaymentMethod.paymentMethodTypeList.expressCheckout	否	您可以通过设置该参数的值为 `true` 或者在 Antom Dashboard 配置 Google Pay 为极速支付方式。

以下代码展示了一个请求报文的示例：

copy
{
  "order": {
    "buyer": {
      "referenceBuyerId": "yourBuyerId"
    },
    "goods": [
      {
        "goodsBrand": "Antom Brand",
        "goodsCategory": "outdoor goods/bag",
        "goodsImageUrl": "https://mdn.alipayobjects.com/portal_pdqp4x/afts/file/A*H8M9RrxlArAAAAAAAAAAAAAAAQAAAQ",
        "goodsName": "Classic Woman Bag",
        "goodsQuantity": "1",
        "goodsSkuName": "Black",
        "goodsUnitAmount": {
          "currency": "SGD",
          "value": "6000"
        },
        "goodsUrl": "https://yourGoodsUrl",
        "referenceGoodsId": "yourGoodsId"
      }
    ],
    "orderAmount": {
      "currency": "SGD",
      "value": "6000"
    },
    "orderDescription": "antom ckp testing order",
    "referenceOrderId": "c3df9b82-ff67-424b-880b-06c3615b46ea"
  },
  "paymentAmount": {
    "currency": "SGD",
    "value": "6000"
  },
  "availablePaymentMethod": {
    "paymentMethodTypeList": [
      {
        "paymentMethodType": "GOOGLEPAY",
        "expressCheckout": false,
        "paymentMethodOrder": 1
      }
    ]
  },
  "paymentNotifyUrl": "http://www.yourNotifyUrl.com/payment/receiveNotify",
  "paymentRedirectUrl": "http://localhost:8080/index.html?paymentRequestId=597795b7-c812-4132-bd7d-c55914eefdcb",
  "paymentRequestId": "597795b7-c812-4132-bd7d-c55914eefdcb",
  "productCode": "CASHIER_PAYMENT",
  "productScene": "CHECKOUT_PAYMENT"
}

步骤 2：嵌入 Antom Checkout Page 客户端

SDK 是用于处理支付流程的组件，为了收集信息以及根据 createPaymentSession（单笔支付）接口中指定的支付方式在应用间切换，您需要通过创建支付会话来启动 SDK，具体操作请参阅步骤 2：嵌入 Antom Checkout Page。

步骤 3：获取支付结果服务端

在买家完成支付或支付超时后，您可以接收来自 Antom 的异步通知或通过主动查询来获取支付结果，具体步骤请参阅异步通知处理和查询交易。

步骤 4：请款服务端

支付成功后，Antom 默认自动为您请款，同时支持您手动发起请款。请款后，您可以通过异步通知或主动查询来获取请款结果，您需要根据请款结果来决定是否发货。具体操作请参阅请款。

支付后操作

完成支付后，您可对交易进行以下支付后的操作：

退款服务端

若您需要了解 Antom 的退款规则及如何对成功的交易发起退款，详情请参见退款。

争议服务端

若买家选择使用卡支付方式，会涉及到争议相关的集成，详情请参见争议。

对账服务端

交易完成后，使用 Antom 提供的财务报告进行对账。有关如何对账和 Antom 结算规则的更多信息，请参阅对账。

更多内容

卡支付特性

卡支付特性同样适用于 Google Pay，以下列举了卡支付特性在 Google Pay 的支持情况：

类型	是否支持	说明
Antom Tokenization	条件支持	CIT（持卡人发起交易）场景不支持，建议您通过 Google 账户存卡。 MIT（商户发起交易）场景支持。
卡信息存档交易（COF）	支持	无。
3D Secure 2	支持	您将 paymentMethodMetaData.googlePayConfiguration.allowedAuthMethods 参数设为 `CRYPTOGRAM_3DS` 或使用了默认值，并且 Google Pay 侧已经完成 3DS 验证，Antom 按第三方机构 3DS 处理流程，Checkout Page 不会出现支付方式侧 3DS 的体验，详情请参阅 Google Pay - 为全球符合条件的 Visa 设备令牌交易启用责任转移。您将 paymentMethodMetaData.googlePayConfiguration.allowedAuthMethods 参数设为 `CRYPTOGRAM_3DS` 和 `PAN_ONLY` 或使用默认值，如 Google Pay 侧未完成 3DS 验证，Checkout Page会根据您传入的 is3DSAuthentication 和 enableAuthenticationUpgrade 决策是否需要 3DS 验证。
Antom 3DS-Retry	支持	无。
商户发起交易（MIT）	支持	无。
分期付款	不支持	无。

指定支付方式

您可以在 Antom Dashboard 的 支付 > 收银台设置 > 支付方式 中配置指定支付方式。您也可以通过在 createPaymentSession（单笔支付）接口传入参数，指定在 Checkout Page 上展示的支付方式、支付方式列表的排序，以及极速支付方式的展示。

注意：如果您通过接口传入参数来指定支付方式，则优先取接口传值。

此功能为您带来以下优势：

根据您的业务地区过滤当地的支付方式
按照您的偏好对支付方式进行排序
可以将主流的支付方式如 Alipay、Apple Pay、Google Pay 以极速支付的形式展示

要指定 Google Pay 为唯一支付方式，请在 createPaymentSession（单笔支付）接口的 availablePaymentMethod 参数中，传入以下参数：

以下是指定 Google Pay 为唯一支付方式的示例代码：

copy
{
  "availablePaymentMethod": {
    "paymentMethodTypeList": [
      {
        "paymentMethodType": "GOOGLEPAY",
        "expressCheckout": true,
        "paymentMethodOrder": "0"
      }
    ]
  }
}