此页面由 Cloud Translation API 翻译。

设置沙盒付款

订购端到端项目可在以下情况下配置沙盒付款方式：测试环境测试数据时 Feed 支持在沙盒付款方式和正式版付款方式之间切换。为此，在不向银行卡收费的情况下测试订购端到端项目的付款功能，请使用沙盒作为您的付款方式。生产环境不支持沙盒付费模式。

配置

要在沙盒环境中启用沙盒付费模式，请按以下步骤操作：步骤：

在 Actions Center（操作中心）中，依次转到 Configuration（配置）> 功能。
在账号功能卡片中，找到付款方式单选按钮。
选择沙盒选项，然后点击保存更改。

已选择沙盒模式的账号功能卡片

如需在快速测试环境中启用沙盒付费模式，请按以下步骤操作：步骤：

在 Actions Center（操作中心）中，前往 Feeds（Feed） > 快速测试。
选择使用 GPay 沙盒单选按钮。

已选择沙盒模式的快速测试

选择沙盒付费模式后：

端到端订购会将 Google Pay 配置为返回符合以下条件的付款工具令牌：包含测试卡数据，而不是实际卡详细信息。
在isInSandboxtrue CheckoutRequestMessage 和 SubmitOrderRequestMessage.

环境、付费模式和 isInSandbox 的不同组合如下：

环境	付费模式	isInSandbox
快速测试	沙盒	true
快速测试	生产	false
沙盒	沙盒	true
沙盒	生产	false
生产	生产	false

结账响应消息

您的订餐网络服务发送的 CheckoutResponseMessage 包含 PaymentOptions。当您设置您的结账页，您使用示例支付网关提供占位符付款方式。

请务必更新通过您的网站发送的CheckoutResponseMessage 具有适当的标记化配置的服务。

。 <ph type="x-smartling-placeholder">

付款方式示例

以下是来自PaymentOptions CheckoutResponseMessage：适用于使用沙盒密钥的各种支付网关：

JSON

"paymentOptions": {
    "googleProvidedOptions": {
        "facilitationSpecification": "{\"apiVersion\":2,\"apiVersionMinor\":0,\"merchantInfo\":{\"merchantName\":\"merchantName\"},\"allowedPaymentMethods\":[{\"type\":\"CARD\",\"parameters\":{\"allowedAuthMethods\":[\"PAN_ONLY\"],\"allowedCardNetworks\":[\"VISA\",\"MASTERCARD\"],\"billingAddressRequired\":true,\"cvcRequired\":false},\"tokenizationSpecification\":{\"type\":\"PAYMENT_GATEWAY\",\"parameters\":{\"gatewayMerchantId\":\"YOUR_MERCHANT_ID\",\"gateway\":\"cybersource\"}}}],\"transactionInfo\":{\"currencyCode\":\"USD\",\"totalPriceStatus\":\"ESTIMATED\",\"totalPrice\":\"31.85\"}} "
    }
}

JSON

"paymentOptions": {
    "googleProvidedOptions": {
        "facilitationSpecification": "{\"apiVersion\":2,\"apiVersionMinor\":0,\"merchantInfo\":{\"merchantName\":\"merchantName\"},\"allowedPaymentMethods\":[{\"type\":\"CARD\",\"parameters\":{\"allowedAuthMethods\":[\"PAN_ONLY\"],\"allowedCardNetworks\":[\"VISA\",\"MASTERCARD\"],\"billingAddressRequired\":true,\"cvcRequired\":false},\"tokenizationSpecification\":{\"type\":\"PAYMENT_GATEWAY\",\"parameters\":{\"gateway\":\"braintree\",\"braintree:apiVersion\":\"v1\",\"braintree:sdkVersion\":\"1.4.0\",\"braintree:merchantId\":\"YOUR_MERCHANT_ID\",\"braintree:clientKey\":\"YOUR_BRAINTREE_SANDVOX_OR_PRODUCTION_KEY\"}}}],\"transactionInfo\":{\"currencyCode\":\"USD\",\"totalPriceStatus\":\"ESTIMATED\",\"totalPrice\":\"31.85\"}} "
    }
}

JSON

"paymentOptions": {
    "googleProvidedOptions": {
        "facilitationSpecification": "{\"apiVersion\":2,\"apiVersionMinor\":0,\"merchantInfo\":{\"merchantName\":\"merchantName\"},\"allowedPaymentMethods\":[{\"type\":\"CARD\",\"parameters\":{\"allowedAuthMethods\":[\"PAN_ONLY\"],\"allowedCardNetworks\":[\"VISA\",\"MASTERCARD\"],\"billingAddressRequired\":true,\"cvcRequired\":false},\"tokenizationSpecification\":{\"type\":\"PAYMENT_GATEWAY\",\"parameters\":{\"gateway\":\"stripe\",\"stripe:version\":\"2018-10-31\",\"stripe:publishableKey\":\"YOUR_PRODUCTION_OR_SANDBOX_STRIPE_KEY\"}}}],\"transactionInfo\":{\"currencyCode\":\"USD\",\"totalPriceStatus\":\"ESTIMATED\",\"totalPrice\":\"31.85\"}} "
    }
}

JSON

"paymentOptions": {
    "googleProvidedOptions": {
        "facilitationSpecification": "{\"apiVersion\":2,\"apiVersionMinor\":0,\"merchantInfo\":{\"merchantName\":\"merchantName\"},\"allowedPaymentMethods\":[{\"type\":\"CARD\",\"parameters\":{\"allowedAuthMethods\":[\"PAN_ONLY\"],\"allowedCardNetworks\":[\"VISA\",\"MASTERCARD\"],\"billingAddressRequired\":true,\"cvcRequired\":false},\"tokenizationSpecification\":{\"type\":\"PAYMENT_GATEWAY\",\"parameters\":{\"gateway\":\"stripev2\",\"gatewayMerchantId\":\"YOUR_PRODUCTION_OR_SANDBOX_STRIPE_KEY\"}}}],\"transactionInfo\":{\"currencyCode\":\"USD\",\"totalPriceStatus\":\"ESTIMATED\",\"totalPrice\":\"31.85\"}} "
    }
}

标记沙盒交易

启用沙盒付款模式后，isInSandbox 字段将变为包含在请求中，并设置为 true（针对发送到您网站的请求）服务端点（CheckoutRequestMessage 和 SubmitOrderRequestMessage）。当 isInSandbox 字段设置为 true 时，请执行以下操作：

在令牌化过程中使用沙盒密钥（而非生产密钥）配置。大多数付款处理方都提供 API 测试密钥
请勿触发与 Web 服务提供商（通常是因为他们不需要获知任何沙盒交易

不支持测试信用卡，即使交易沙盒是。您必须使用真实的信用卡进行交易。不过，沙盒付款方式令牌包含不可扣款的测试卡详细信息。

处理付款

当客户提交订单时，端到端订单会发送 SubmitOrderRequestMessage 您的 Web 服务端点。Google Pay 令牌以 base-64 编码字符串形式包含在 SubmitOrderRequestMessage 中 instrumentToken 字段。要处理客户付款，请根据具体情况采取下列措施之一支付网关：

支付网关
Stripe 或 Braintree	对 base-64 编码的令牌字符串进行解码，并将解码的令牌载荷中包含的相应数据发送到您的付款网关来处理付款。
所有其他支付网关（包括 tripev2）	将完整的 base-64 编码令牌字符串发送至您的支付网关 API 以处理付款。Google Pay 付款方式令牌结构包含加密字段，支付网关可以解密这些字段来处理付款。

解码后的载荷示例

以下示例展示了 instrumentToken 中返回的已解码载荷字段：

JSON

此 JSON 示例表示使用 Braintree.提取 nonce 字段的值并将值发送给 Braintree 来处理付款。

{
  "androidPayCards": [{
    "type": "AndroidPayCard",
    "nonce": "aeeb8297-4242...",
    "description": "AndroidPay",
    "consumed": false,
    "details": {
      "cardType": "Visa",
      "lastTwo": "29"
    }
  }]
}

如果您未在 Braintree 控制面板中启用 Google Pay， instrumentToken 字段会解码为以下错误：

{
  "error": {
    "message": "Record not found"
  },
  "fieldErrors": []
}

JSON

以下 JSON 示例表示使用 Stripe 时已解码的付款令牌。提取 id 字段的值并将其发送到 Stripe，处理付款。

{
  "id": "tok_abcdefg1234...",
  "object": "token",
  "card": {
    "id": "card_abcde...",
    "object": "card",
    "address_city": null,
    "address_country": null,
    "address_line1": null,
    "address_line1_check": null,
    "address_line2": null,
    "address_state": null,
    "address_zip": null,
    "address_zip_check": null,
    "brand": "Visa",
    "country": "US",
    "cvc_check": null,
    "dynamic_last4": "1234",
    "exp_month": 1,
    "exp_year": 2019,
    "funding": "credit",
    "last4": "1234",
    "metadata": {},
    "name": null,
    "tokenization_method": "android_pay"
  },
  "client_ip": "74.125.177.36",
  "created": 1500483670,
  "livemode": false,
  "type": "card",
  "used": false
}

JSON

以下 JSON 示例表示使用 tripev2 时已解码的付款令牌。

  {
  "protocolVersion":"ECv2",
  "signature":"MEQCIH6Q4OwQ0jAceFEkGF0JID6sJNXxOEi4r+mA7biRxqBQAiAondqoUpU/bdsrAOpZIsrHQS9nwiiNwOrr24RyPeHA0Q\u003d\u003d",
  "intermediateSigningKey":{
    "signedKey": "{\"keyExpiration\":\"1542323393147\",\"keyValue\":\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE/1+3HBVSbdv+j7NaArdgMyoSAM43yRydzqdg1TxodSzA96Dj4Mc1EiKroxxunavVIvdxGnJeFViTzFvzFRxyCw\\u003d\\u003d\"}",
    "signatures": ["MEYCIQCO2EIi48s8VTH+ilMEpoXLFfkxAwHjfPSCVED/QDSHmQIhALLJmrUlNAY8hDQRV/y1iKZGsWpeNmIP+z+tCQHQxP0v"]
  },
  "signedMessage":"{\"tag\":\"jpGz1F1Bcoi/fCNxI9n7Qrsw7i7KHrGtTf3NrRclt+U\\u003d\",\"ephemeralPublicKey\":\"BJatyFvFPPD21l8/uLP46Ta1hsKHndf8Z+tAgk+DEPQgYTkhHy19cF3h/bXs0tWTmZtnNm+vlVrKbRU9K8+7cZs\\u003d\",\"encryptedMessage\":\"mKOoXwi8OavZ\"}"
}

JSON

以下 JSON 示例表示使用 Square 时已解码的付款令牌。

  {
    "signature": "MEYCIQCMAsWCrY2GfHM/gMAKiK3QCKJJOIkjZeTQGzcdWgvrhwIhAJ3mXwe+wmU9z+Apv1rTDsCVQBzayvWzT4ywxytrSPla",
    "protocolVersion": "ECv1",
    "signedMessage": "{\"encryptedMessage\":\"WkYz21EYxojwTqWh6A3oYXtmctu1PlqF+tNYPA4cq017nqj16Ge7kaVR7MI1XG1OrCmcMwP20u5Zb5E28XYan8UI8M4L120orvE9XU1ivZuO4Myq2O3ue8v0lY1MDx8Mnk+5mkAv1kLmzJc91gEQ2leIwrPuMDYqsQUHzTR3Jikh5/v+iWRkyQPKKxgj5c6Erdu/pkg1xV6fQJcHNdq9Jw11zl95x6eQurxw2Uy8v811azGr+noKJbw0uye72MkhmzMS5QKOzwGT9nBfO+zPLYSEewsdOcPbNZF94zk/KU9nxom/gQ+eYEMIZvOj9lO4gQqDqR6DyWyStk7MjeXQTvXWZBI1JpqvOrlTHL0Ct18RpbfOio7hAtafzb0NnqEKlsun+SSpJmvI7U6n6Cnu1JUMUGfT/Jsi6RJ3N6pRw2BubeR1925Xl3jXQnlz5io6X1YRlAcnshZyf6CjBpKES32aTf1m1IHRhZ2Jj6i/g7Y\\u003d\",\"ephemeralPublicKey\":\"BDQA0Cf//BHPcnB0R/GRrWa2g7T1QF97eOhAYy7l45M+kJnsoeL9OaUQV/KIMLvcgbmKkZIm2FQeL7ftd6S4q4c\\u003d\",\"tag\":\"DHtVyXNo+PDr7Thi/EjBBbsr2k7y1SwGIn0D9mmPTJc\\u003d\"}"
  }

如需使用令牌处理付款，请将您向 Square 的付款 API 发出的请求返回 base-64 编码的令牌字符串，该请求位于 source_id 字段中（前缀为 gpay:）

  {
    "idempotency_key": "ID",
    "source_id": "gpay:GOOGLE_PAY_BASE64_ENCODED_TOKEN",
    "amount_money": {
        "amount": 50,
        "currency": "USD"
    },
    "location_id": "LOCATION_ID",
    "billing_address": {
        "postal_code": "11111"
    }
  }

下面的 Node.js 示例将 base-64 编码为 Braintree 的 instrumentToken：

Node.js

function decodeToken(instrumentToken) {
  let decodedString = new Buffer(instrumentToken, 'base64').toString('ascii')
  if (decodedString.androidPayCards) {
    return decodedString.androidPayCards[0].nonce;
  }
}