PaymentOptions

Optionen für die Zahlung einer Bestellung.

JSON-Darstellung
{

  // Union field payment_option can be only one of the following:
  "googleProvidedOptions": {
    object(GoogleProvidedPaymentOptions)
  },
  "actionProvidedOptions": {
    object(ActionProvidedPaymentOptions)
  }
  // End of list of possible types for union field payment_option.
}
Felder
Union-Feld payment_option. Zahlungsoptionen. Für payment_option ist nur einer der folgenden Werte zulässig:
googleProvidedOptions

object(GoogleProvidedPaymentOptions)

Anforderungen an das von Google bereitgestellte Zahlungsmittel

actionProvidedOptions

object(ActionProvidedPaymentOptions)

Informationen zu einem von der Aktion bereitgestellten Zahlungsmittel, das auf dem Beleg angezeigt wird.

GoogleProvidedPaymentOptions

Anforderungen an die von Google bereitgestellte Zahlungsmethode

JSON-Darstellung
{
  "tokenizationParameters": {
    object(PaymentMethodTokenizationParameters)
  },
  "supportedCardNetworks": [
    enum(CardNetwork)
  ],
  "prepaidCardDisallowed": boolean,
  "billingAddressRequired": boolean
}
Felder
tokenizationParameters

object(PaymentMethodTokenizationParameters)

Pflichtfeld zum Anfordern des von Google bereitgestellten Zahlungsmittels. Diese Tokenisierungsparameter werden zum Generieren von Zahlungstokens für Transaktionen verwendet. Die App sollte diese Parameter von ihrem Zahlungs-Gateway abrufen.

supportedCardNetworks[]

enum(CardNetwork)

In der App können Karten von jedem hier aufgeführten Kartennetzwerk für Transaktionen verwendet werden. Standardmäßig werden American Express, Visa, MC und Discover unterstützt.

prepaidCardDisallowed

boolean

Wenn „true“ festgelegt ist, dürfen bei der Transaktion keine Prepaidkarten verwendet werden.

billingAddressRequired

boolean

Bei „true“ wird die Rechnungsadresse zurückgegeben.

PaymentMethodTokenizationParameters

Partner MÜSSEN die Parameter für die Tokenisierung angeben, wenn die von Nutzern bei Google gespeicherten Zahlungsmethoden bei der Transaktion verwendet werden. Der Partner sollte diese Parameter aus seinem eigenen Zahlungsgateway abrufen können.

JSON-Darstellung
{
  "tokenizationType": enum(PaymentMethodTokenizationType),
  "parameters": {
    string: string,
    ...
  }
}
Felder
tokenizationType

enum(PaymentMethodTokenizationType)

Erforderlich.

parameters

map (key: string, value: string)

Wenn „tokenizationType“ auf PAYMENT_GATEWAY gesetzt ist, sollte die Liste der Parameter zahlungsgateway-spezifische Parameter enthalten, die zur Tokenisierung der Zahlungsmethode erforderlich sind, sowie einen Parameter mit dem Namen „gateway“, dessen Wert auf eines der unterstützten Gateways festgelegt ist, z.B. „stripe“ oder „braintree“. Eine Beispielkonfiguration für die Tokenisierung, die für Stripe im JSON-Format verwendet wird. { "gateway" : "stripe", "stripe:publishableKey" : "pk_1234", "stripe:version" : "1.5" } Eine Beispielkonfiguration für die Tokenisierung, die für Braintree im JSON-Format verwendet wird. { "gateway" : "braintree", "braintree:merchantId" : "abc" "braintree:sdkVersion" : "1.4.0" "braintree:apiVersion" : "v1" "braintree:clientKey" : "production_a12b34" "braintree:authorizationFingerprint" : "production_a12b34" } Eine Beispielkonfiguration für Adyen im JSON-Format. { "gateway" : "adyen", "gatewayMerchantId" : "gateway-merchant-id" } Wenn „tokenizationType“ auf DIRECT gesetzt ist, müssen Integratoren einen Parameter mit dem Namen „publicKey“ angeben, der einen öffentlichen Schlüssel mit elliptischer Kurve im unkomprimierten Punktformat und base64-codiert enthält. Dieser „publicKey“ wird von Google zur Verschlüsselung der Zahlungsinformationen verwendet. Beispiel für den Parameter im JSON-Format: { "publicKey": "base64encoded..." }

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ActionProvidedPaymentOptions

Anforderungen an die von der Aktion bereitgestellte Zahlungsmethode

JSON-Darstellung
{
  "paymentType": enum(PaymentType),
  "displayName": string
}
Felder
paymentType

enum(PaymentType)

Zahlungsart. Erforderlich.

displayName

string

Name des Zahlungsmittels, der auf dem Beleg angegeben ist Erforderlich für von einer Aktion bereitgestellte Zahlungsinformationen. Bei PAYMENT_CARD könnte das z. B. „VISA-1234“ sein. Für BANK könnte das „Chase Inspection-1234“ sein. Für LOYALTY_PROGRAM könnte das „Starbucks Punkte“ sein. Bei ON_FULFILLMENT könnte das etwa „Nachnahme“ lauten.