Konfiguration des Google Pay-Zahlungs-Handlers

Diese Referenz basiert auf dem Schema des Konfigurationsobjekts für den Google Pay-Zahlungs-Handler 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,
        "billing_address_required": boolean,
        "billing_address_parameters": {
          "format": "MIN" | "FULL" | "FULL-ISO3166",
          "phone_number_required": boolean
        }
      },
      "tokenization_specification": {
        "type": "PAYMENT_GATEWAY" | "DIRECT",
        "parameters": {
          ...
        }
      },
    }
  ]
}

Properties

Immobilien Typ Notwendigkeit Beschreibung
api_version integer Erforderlich Die Hauptversion der Google Pay API. Nur 2 wird unterstützt.
api_version_minor integer Erforderlich Die Nebenversionsnummer der Google Pay API. Nur 0 wird unterstützt.
environment String Erforderlich Die zu verwendende Google Pay-Umgebung.
  • TEST: Nur zum Testen 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 Unternehmensname des Händlers.
merchant_info.merchant_origin String Optional Die vollständig qualifizierte Webdomain, auf der die Kaufabwicklung erfolgt (Format: hostname).
merchant_info.auth_jwt String Optional Autorisierungs-JWT für bestimmte Integrationskontexte.
allowed_payment_methods object[ ] Erforderlich Die für diese Transaktion zulässigen Zahlungsmethoden.
allowed_payment_methods[].type String Erforderlich Die Art der unterstützten Zahlungsmethode. Unterstützte Werte: CARD und EWALLET.
allowed_payment_methods[].parameters Objekt Optional Parameter, die zum Konfigurieren der Zahlungsmethode CARD erforderlich sind. Diese Property ist erforderlich, wenn type gleich CARD ist.
allowed_payment_methods[].parameters.allowed_auth_methods string[ ] 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 string[ ] 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 Auf false setzen, wenn Sie keine Prepaidkarten unterstützen. Der Standardwert ist true.
allowed_payment_methods[].parameters.allow_credit_cards boolean Optional Legen Sie den Wert auf false fest, wenn Sie keine Kreditkarten unterstützen. Der Standardwert ist true.
allowed_payment_methods[].parameters.billing_address_required boolean Optional Auf true setzen, wenn eine Rechnungsadresse für den Abschluss der Transaktion erforderlich ist.
allowed_payment_methods[].parameters.billing_address_parameters Objekt Optional Parameter zum Konfigurieren der zurückgegebenen Rechnungsadresse.
allowed_payment_methods[].parameters.billing_address_parameters.format String Optional Das Format der Rechnungsadresse, 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 Sie eine Telefonnummer benötigen, um die Transaktion abzuschließen.
allowed_payment_methods[].tokenization_specification Objekt Optional Konfiguration, die definiert, wie Zahlungsanmeldedaten an Sie zurückgegeben werden. Diese Property ist erforderlich, wenn type gleich CARD ist.
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 Zahlungsdienstleister übergeben werden soll.
  • DIRECT: Wird verwendet, wenn Sie Anmeldedaten selbst entschlüsseln (erfordert PCI DSS-Compliance der Stufe 1).
allowed_payment_methods[].tokenization_specification.parameters Objekt Erforderlich Parameter, die für die ausgewählte Tokenisierung type spezifisch sind.

Für PAYMENT_GATEWAY sind die erforderlichen Parameter: Für DIRECT sind die erforderlichen Parameter:
allowed_payment_methods[].processing_specification Objekt Optional Definieren Sie die Informationen, die für die Verarbeitung der Zahlung erforderlich sind. Diese Property ist erforderlich, wenn type gleich EWALLET ist.
allowed_payment_methods[].processing_specification.type String Erforderlich Der Typ des E-Wallet-Anbieters. Unterstützte Werte: SHOPEE_PAY und TOUCH_N_GO.
allowed_payment_methods[].processing_specification.parameters Objekt Erforderlich Parameter, die für den ausgewählten E-Wallet-Anbieter spezifisch sind.

Die erforderlichen Parameter sind:
  • ewallet_merchant_name: Der für Nutzer sichtbare Anzeigename des Händlers.
  • ewallet_merchant_account: Vom E-Wallet oder Aggregator ausgegebene Händler-ID.
  • psp_transaction_reference: Eine eindeutige Referenznummer, die vom Zahlungsdienstleister zur Gewährleistung der Idempotenz generiert wird.