JSON-Antwortobjekte

In dieser Referenz werden die Optionen für das Google Pay API-Antwortobjekt beschrieben, die Sie mit Ihrer Anwendung verwenden können. Antwortobjekte sind Objekte, die von den Client-Methoden der Google Pay API zurückgegeben werden.

PaymentData

Dies ist ein Antwortobjekt, das von Google zurückgegeben wird, nachdem ein Zahlungspflichtiger die Zahlung genehmigt hat.

PaymentDataRequest.PaymentDataRequest.PaymentDataRequest.
Attribut Typ Immer vorhanden Beschreibung
apiVersion Zahl Ja Haupt-API-Version. Der Wert in der Antwort entspricht dem Wert, der in
apiVersionMinor Zahl Ja Nebenversion der API. Der Wert in der Antwort entspricht dem Wert, der in
paymentMethodData PaymentMethodData Ja Daten zur ausgewählten Zahlungsmethode.
email String Nein E-Mail-Adresse, wenn emailRequired in der PaymentDataRequest auf true gesetzt ist. PaymentDataRequest. Wenn die Property in einer anderen Anfrage auf true festgelegt ist, hat das keine Auswirkungen.
shippingAddress Adresse Nein Versandadresse, wenn shippingAddressRequired in der PaymentDataRequest auf true festgelegt ist.

Beispiel

In dieser Beispielantwort für die Google Pay API-Version 2.0 ist eine CARD-Zahlungsmethode zu sehen, die im Google Pay-Zahlungsblatt ausgewählt wurde. Für das example-Gateway wurde ein Zahlungsmethoden-Token generiert.

{
  "apiVersion": 2,
  "apiVersionMinor": 0,
  "paymentMethodData": {
    "type": "CARD",
    "description": "Visa •••• 1234",
    "info": {
      "cardNetwork": "VISA",
      "cardDetails": "1234",
      "cardFundingSource": "CREDIT"
    },
    "tokenizationData": {
      "type": "PAYMENT_GATEWAY",
      "token": "examplePaymentMethodToken"
    }
  }
}

PaymentMethodData

Dieses Objekt enthält Daten für eine ausgewählte Zahlungsmethode.

Attribut Typ Immer vorhanden Beschreibung
type String Ja PaymentMethod type im Google Pay-Zahlungsblatt ausgewählt.
description String Ja

Für Nutzer sichtbare Nachricht zur Beschreibung der Zahlungsmethode, mit der diese Transaktion finanziert wird.
info Objekt Ja Der Wert dieser Eigenschaft hängt von der zurückgegebenen Zahlungsmethode type ab. Informationen zu CARD finden Sie unter CardInfo.
tokenizationData PaymentMethodTokenizationData Nein Daten zur Zahlungstokenisierung für die ausgewählte Zahlungsmethode.

Beispiel

In dieser Beispielantwort wird gezeigt, wie für eine CARD-Zahlungsmethode, die im Google Pay-Zahlungsformular ausgewählt ist, ein Zahlungsmethoden-Token für das example-Gateway generiert wird.

{
  "type": "CARD",
  "description": "Visa •••• 1234",
  "info": {
    "cardNetwork": "VISA",
    "cardDetails": "1234"
  },
  "tokenizationData": {
    "type": "PAYMENT_GATEWAY",
    "token": "examplePaymentMethodToken"
  }
}

CardInfo

Dieses Objekt enthält Informationen zur ausgewählten Zahlungskarte.

Attribut Typ Immer vorhanden Beschreibung
cardDetails String Ja Details zur Karte. Dieser Wert entspricht in der Regel den letzten vier Ziffern der ausgewählten Zahlungskontonummer.
assuranceDetails AssuranceDetailsSpecifications Ja Dieses Objekt enthält Informationen zur Validierung der zurückgegebenen Zahlungsdaten, wenn assuranceDetailsRequired in den CardParameters.
cardNetwork String Ja

Das Zahlungskartennetzwerk der ausgewählten Zahlung. Die zurückgegebenen Werte entsprechen dem Format von allowedCardNetworks in CardParameters.

Dieser Wert des Kartennetzwerks sollte dem Käufer nicht angezeigt werden. Sie wird verwendet, wenn die Kartendetails eines Käufers benötigt werden. Beispiel: Der Kundensupport benötigt diesen Wert, um die Karte zu identifizieren, die ein Käufer für seine Transaktion verwendet hat. Verwenden Sie stattdessen die Property description von PaymentMethodData für eine für Nutzer sichtbare Beschreibung.
billingAddress Adresse Nein Die Rechnungsadresse, die mit der angegebenen Zahlungsmethode verknüpft ist, wenn billingAddressRequired in CardParameters.
cardFundingSource String Ja

Kartenfinanzierungsquelle für die ausgewählte Zahlungsmethode.

  • UNKNOWN
  • CREDIT
  • DEBIT
  • PREPAID

Beispiel

In diesem Beispiel ist eine Karte im Visa-Netzwerk zu sehen.

{
  "cardNetwork": "VISA",
  "cardDetails": "1234",
  "cardFundingSource": "CREDIT",
  "assuranceDetails": {
    "cardHolderAuthenticated": false,
    "accountVerified": true
  }
}

AssuranceDetailsSpecifications

Dieses Objekt enthält Informationen dazu, welche Validierung für die zurückgegebenen Zahlungsanmeldedaten durchgeführt wurde, damit entsprechende Risikoprüfungen für das Zahlungsmittel angewendet werden können.

Name Typ Beschreibung
accountVerified Boolesch Wenn true, bedeutet das, dass die Validierung des Besitzes von Cardholder für die zurückgegebenen Zahlungsanmeldedaten durchgeführt wurde.
cardHolderAuthenticated Boolesch

Wenn true, gibt dies an, dass die Identifizierung und Bestätigung (ID&V) für die zurückgegebenen Zahlungsanmeldedaten durchgeführt wurde.

Wenn false, kann dieselbe risikobasierte Authentifizierung wie bei Kartentransaktionen durchgeführt werden. Diese risikobasierte Authentifizierung kann unter anderem eine zusätzliche Bestätigung mit dem 3D Secure-Protokoll umfassen, sofern zutreffend.

Sie können das Antwortobjekt auch dann empfangen und verarbeiten, wenn Sie das Feld assuranceDetails nicht verwenden. Wenn Sie dieses Objekt erhalten möchten, fügen Sie assuranceDetailsRequired: true in die CardParameters.

PaymentMethodTokenizationData

Dieses Objekt enthält Tokenisierungsdaten für die Zahlungsmethode.

Attribut Typ Immer vorhanden Beschreibung
type String Ja Die Art der Tokenisierung, die auf die ausgewählte Zahlungsmethode angewendet werden soll. Dieser Wert entspricht dem in PaymentMethodTokenizationSpecification.
token String Nein

Das generierte Zahlungsmethoden-Token.

Beispiel

Dies ist ein Beispiel für eine tokenisierte Antwort, die für das example-Gateway vorbereitet wurde.

{
  "type": "PAYMENT_GATEWAY",
  "token": "examplePaymentMethodToken"
}

Adresse

Dieses Objekt enthält Informationen zu einer angeforderten Postanschrift. Alle Attribute sind Strings.

Adressen können in den Formaten MIN, FULL und FULL-ISO3166 zurückgegeben werden. Die Attribute der einzelnen Formate sind in der folgenden Tabelle aufgeführt.

Attribut Adressformat Beschreibung
name MIN, FULL, FULL-ISO3166 Der vollständige Name des Empfängers.
postalCode MIN, FULL, FULL-ISO3166 Die Postleitzahl.
countryCode MIN, FULL, FULL-ISO3166 ISO 3166-1 Alpha-2-Ländercode.
phoneNumber MIN, FULL, FULL-ISO3166 Eine Telefonnummer, wenn phoneNumberRequired in der PaymentDataRequest.
address1 FULL, FULL-ISO3166 Die erste Zeile der Adresse.
address2 FULL, FULL-ISO3166 Die zweite Zeile der Adresse.
address3 FULL, FULL-ISO3166 Die dritte Zeile der Adresse.
locality FULL, FULL-ISO3166 Stadt, Stadtteil oder Vorort
administrativeArea FULL, FULL-ISO3166 Eine Unterteilung eines Landes, z. B. ein Bundesland oder eine Provinz.
sortingCode FULL, FULL-ISO3166 Der Sortiercode.
iso3166AdministrativeArea FULL-ISO3166 Der ISO 3166-2-Code für das Verwaltungsgebiet, der „administrativeArea“ entspricht.

Beispiel

Dies ist ein Beispiel für eine Adresse im FULL-ISO3166-Format in den USA mit mehreren Zeilen mit Straßenadressdaten.

{
  "name": "John Doe",
  "address1": "c/o Google LLC",
  "address2": "1600 Amphitheatre Pkwy",
  "address3": "Building 40",
  "locality": "Mountain View",
  "administrativeArea": "CA",
  "countryCode": "US",
  "postalCode": "94043",
  "sortingCode": ""
  "iso3166AdministrativeArea": "US-CA"
}