本頁面由 Cloud Translation API 翻譯而成。

設定沙箱付款功能

訂購端對端專案後，即可設定沙箱付款方式，您可以使用快速測試或沙箱環境測試資料時並在沙箱和正式環境付款模式間切換。為了測試訂購端對端專案而不向卡片收費，請使用「沙箱」做為付款方式。正式環境沒有支援沙箱付款模式

設定

如要在沙箱環境中啟用沙箱付款模式，請按照下列步驟操作：步驟：

在動作中心中，依序前往「設定」>「功能」。
在「帳戶功能」資訊卡中，找出「付款方式」圓形按鈕。
選取「沙箱」選項，然後按一下「儲存變更」。

已選取沙箱模式的帳戶功能資訊卡

如要在快速測試環境中啟用沙箱付款模式，請按照下列步驟操作：步驟：

在動作中心，前往「動態饋給」 >「快速測試」。
選取「Use sandbox for GPay」圓形按鈕。

已選取沙箱模式的快速測試

選取「沙箱」付款模式之後：

端對端排序功能會設定 Google Pay 傳回符合包含測試卡片資料，而非實際卡片資料。
其中的 isInSandbox 欄位已設為 true CheckoutRequestMessage 和 SubmitOrderRequestMessage.

環境、付款模式和 isInSandbox 的不同組合如下：

環境	付款模式	isInSandbox
快速測試	沙箱	true
快速測試	正式版	false
沙箱	沙箱	true
沙箱	正式版	false
正式版	正式版	false

結帳回應訊息

你的訂餐網路服務傳送的 CheckoutResponseMessage 包含 PaymentOptions。當您設定結帳流程您透過範例支付閘道提供預留位置付款選項。

請務必更新網頁版傳送的CheckoutResponseMessage 並使用合適的權杖化設定服務

，瞭解如何調查及移除這項存取權。

付款方式範例

以下是範例 JSON 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 同時支援沙箱和實際執行環境的金鑰
不會觸發任何與網路服務提供者的通訊，通常是餐廳，因為他們不需要收到任何沙箱交易通知。

不支援測試信用卡，即使交易沙箱進行交易時必須使用真實的信用卡，不過沙箱工具權杖包含無法收費的測試卡片資料。

處理付款

客戶提交訂單時，訂單端對端會將 SubmitOrderRequestMessage 附加至網路服務端點Google Pay 符記是以 Base-64 編碼字串的形式包含在 SubmitOrderRequestMessage 中 instrumentToken ] 欄位。如要處理客戶的付款，請依據實際狀況採取適當的做法閘道：

付款閘道
條紋或布倫特里	將 Base-64 編碼權杖字串解碼，並將已解碼權杖酬載內含的適當資料傳送到付款閘道來處理付款。
所有其他付款閘道 (包括 Steev2)	將完整的 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 範例代表使用 Steev2 時已解碼的付款權杖。

  {
  "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 的 source_id 欄位中傳回採用 Base-64 編碼的權杖字串，前面加上 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"
    }
  }

以下是解碼 base-64 編碼的 Node.js 範例 instrumentToken 來自 Braintree：

Node.js

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

測試權杖化參數

授權與驗證