Google Pay API 商户发起交易的新功能增强

Source: Google Developers Blog

Overview

我们很高兴宣布对 Google Pay API 的新增强功能，这些功能为商户发起的交易（MIT）提供了更大的灵活性和控制力。此更新使开发者能够为更广泛的使用场景（包括订阅、延期付款和自动充值）创建无缝且安全的支付体验。

虽然 Google Pay API 一直支持商户发起的交易，但现有规范主要针对即时的客户发起交易（CIT）而设计。这意味着商户对未来收费的意图无法在 API 请求中完整表达。

通过这些新增强功能，您现在可以清晰地定义未来付款的条款，为用户提供透明度，并确保更顺畅的处理。更新重点关注三类关键的 MIT：

• Recurring Transactions（循环交易）： 适用于订阅或任何用户定期收费的场景。您可以指定诸如试用期、计费频率（每日、每周、每月、每年）、固定或可变金额以及循环持续时间等细节。
• Deferred Transactions（延期交易）： 适用于酒店预订或预售等情形，付款在前期授权，但在未来的某个时间点一次性扣款。您现在可以明确指定延期收费的具体日期和时间。
• Automatic Reload Transactions（自动充值交易）： 适用于当用户账户余额低于某一阈值时自动补足的服务。您可以定义最低余额触发点和充值金额。注意：您仍需根据计费协议自行向用户收取费用。

对开发者和用户的好处

• 提升支付成功率: tokenUpdateUrl 允许您接收关于底层支付凭证（例如卡片到期更新）的通知，帮助确保定期付款的服务不中断。
• 提升透明度: 用户将在 Google Pay 界面中更清晰地了解未来的付款计划。
• 增强灵活性: 支持除即时付款之外的更广泛计费模式。
• 面向未来的兼容性和合规性: Google Pay 提供正确的令牌类型，以确保最佳交易性能并满足未来网络的要求。

关键 API 更改

为支持这些新用例，我们在 PaymentDataRequest 中引入了新对象：

• recurringTransactionInfo – 描述循环支付计划。
• deferredTransactionInfo – 详细说明未来的一次性支付。
• automaticReloadTransactionInfo – 配置基于余额的自动充值。

这些对象让您能够提供关于预期未来交易的细粒度信息。例如，在 recurringTransactionInfo 中，您可以指定：

• introductoryPeriodInfo – 有关任何试用或特殊引导定价的细节。
• recurrenceItems – 一个数组，描述一个或多个循环周期，每个周期都有其自己的价格、状态和持续时间。
• price – 整个循环的总金额（如果固定）。
• managementUrl – 用户管理其循环支付的链接。
• tokenUpdateUrl – Google 用于发送令牌生命周期事件通知的 webhook URL。

示例：简易月度订阅

{
  "apiVersion": 2,
  "apiVersionMinor": 0,
  "allowedPaymentMethods": [
    {
      "type": "CARD"
      // ... other card parameters
    }
  ],
  "recurringTransactionInfo": {
    "label": "Monthly Subscription",
    "transactionId": "SUB12345",
    "recurrenceItems": [
      {
        "label": "Regular Charge",
        "price": "9.99",
        "priceStatus": "FINAL",
        "recurrencePeriod": {
          "unit": "MONTH",
          "count": 1
        }
      }
    ],
    "managementUrl": "https://example.com/subscriptions",
    "tokenUpdateUrl": "https://example.com/api/token-updates"
  }
}

入门

这些新的商户发起交易功能现已可用。我们鼓励您查看更新后的 API 参考文档 以获取有关新对象和属性的完整细节。

我们相信这些增强功能将帮助开发者使用 Google Pay API 构建更强大、更友好的支付解决方案。