Konfiguration des Google Pay-Zahlungs-Handlers

Diese Referenz basiert auf dem Konfigurationsobjekt schema für den Google Pay-Zahlungshandler für das Universal Commerce Protocol (UCP).

{
  "api_version": 2,
  "api_version_minor": 0,
  "environment": "TEST" | "PRODUCTION",
  "merchant_info": {
    "merchant_id": string,
    "merchant_name": string,
    "merchant_origin": string,
    "auth_jwt": string
  },
  "allowed_payment_methods": [
    {
      "type": "CARD",
      "parameters": {
        "allowed_auth_methods": [
          "PAN_ONLY"
        ],
        "allowed_card_networks": [
          "AMEX" | "DISCOVER" | "ELECTRON" | "ELO" | "ELO_DEBIT" | "INTERAC" | "JCB" | "MAESTRO" | "MASTERCARD" | "VISA"
        ],
        "allow_prepaid_cards": boolean,
        "allow_credit_cards": boolean,
        "assurance_details_required": boolean,
        "billing_address_required": boolean,
        "billing_address_parameters": {
          "format": "MIN" | "FULL" | "FULL-ISO3166",
          "phone_number_required": boolean
        }
      },
      "tokenization_specification": {
        "type": "PAYMENT_GATEWAY" | "DIRECT",
        "parameters": {
          ...
        }
      }
    }
  ]
}

Properties

Attribut Typ Erforderlichkeit Beschreibung
api_version Integer Erforderlich Die Hauptversion der Google Pay API. Nur 2 wird unterstützt.
api_version_minor Integer Erforderlich Die Nebenversion der Google Pay API. Nur 0 wird unterstützt.
environment String Erforderlich Die zu verwendende Google Pay-Umgebung.
  • TEST: Nur für Tests verwendete Zahlungsanmeldedaten.
  • PRODUCTION: Echte, autorisierbare Zahlungsanmeldedaten.
merchant_info Objekt Erforderlich Identitätsdetails für den Händler.
merchant_info.merchant_id String Erforderlich Ihre Google Pay-Händler-ID aus der Google Pay & Wallet Console. Dies ist für die PRODUCTION-Umgebung erforderlich. Sie ist optional und wird in der TEST-Umgebung ignoriert.
merchant_info.merchant_name String Optional Der für Nutzer sichtbare Geschäftsname des Händlers.
merchant_info.merchant_origin String Optional Die vollständig qualifizierte Webdomain, auf der der Checkout erfolgt (Format: hostname).
merchant_info.auth_jwt String Optional Autorisierungs-JWT für bestimmte Integrationskontexte.
allowed_payment_methods Objektarray Erforderlich Die für diese Transaktion zulässigen Zahlungsmethoden.
allowed_payment_methods[].type String Erforderlich Der Typ der unterstützten Zahlungsmethode. Nur CARD wird unterstützt.
allowed_payment_methods[].parameters Objekt Erforderlich Parameter, die zum Konfigurieren der Zahlungsmethode CARD erforderlich sind.
allowed_payment_methods[].parameters.allowed_auth_methods Stringarray Erforderlich Felder, die zur Authentifizierung einer Kartentransaktion unterstützt werden.
  • PAN_ONLY: Gibt die primäre Kontonummer (Primary Account Number, PAN) und das Ablaufdatum für eine in Google Wallet gespeicherte Karte zurück.
allowed_payment_methods[].parameters.allowed_card_networks Stringarray Erforderlich Die vom Händler unterstützten Kartennetzwerke. Unterstützte Werte: AMEX, DISCOVER, ELECTRON, ELO, ELO_DEBIT, INTERAC, JCB, MAESTRO, MASTERCARD, VISA.
allowed_payment_methods[].parameters.allow_prepaid_cards Boolean Optional Legen Sie false fest, wenn Sie keine Prepaidkarten unterstützen. Der Standardwert ist true.
allowed_payment_methods[].parameters.allow_credit_cards Boolean Optional Legen Sie false fest, wenn Sie keine Kreditkarten unterstützen. Der Standardwert ist true.
allowed_payment_methods[].parameters.assurance_details_required Boolean Optional Legen Sie true fest, um Details zur Kartenversicherung anzufordern.
allowed_payment_methods[].parameters.billing_address_required Boolean Optional Legen Sie true fest, wenn eine Rechnungsadresse erforderlich ist, um die Transaktion abzuschließen.
allowed_payment_methods[].parameters.billing_address_parameters Objekt Optional Parameter, mit denen die zurückgegebene Rechnungsadresse konfiguriert wird.
allowed_payment_methods[].parameters.billing_address_parameters.format String Optional Das Rechnungsadressformat, das zum Abschließen der Transaktion erforderlich ist.
  • MIN: Name, Ländercode und Postleitzahl (Standard).
  • FULL: Name, Adresse, Ort, Region, Ländercode und Postleitzahl.
  • FULL-ISO3166: Name, Adresse, Ort, Region, Ländercode, Postleitzahl und iso3166AdministrativeArea.
allowed_payment_methods[].parameters.billing_address_parameters.phone_number_required Boolean Optional Legen Sie true fest, wenn eine Telefonnummer erforderlich ist, um die Transaktion abzuschließen.
allowed_payment_methods[].tokenization_specification Objekt Erforderlich Konfiguration, die definiert, wie Zahlungsanmeldedaten an Sie zurückgegeben werden.
allowed_payment_methods[].tokenization_specification.type String Erforderlich Der Tokenisierungstyp.
  • PAYMENT_GATEWAY: Wird verwendet, wenn Sie Zahlungen über ein [unterstütztes Gateway](/pay/api#participating-processors) verarbeiten. Gibt eine verschlüsselte Nutzlast zurück, die an Ihren PSP übergeben werden soll.
  • DIRECT: Wird verwendet, wenn Sie Anmeldedaten selbst entschlüsseln (erfordert PCI DSS Level 1-Compliance).
allowed_payment_methods[].tokenization_specification.parameters Objekt Erforderlich Parameter, die für den ausgewählten Tokenisierungs-type spezifisch sind.

Für PAYMENT_GATEWAY sind die folgenden Parameter erforderlich: Für DIRECT sind die folgenden Parameter erforderlich: