Google Pay-Zahlungsmittel

Diese Referenz basiert auf dem Schema für das Zahlungsmittel „Karte“ für das Zahlungsmittelobjekt, das vom Google Pay-Zahlungsmittel-Handler nach Abschluss des Bezahlvorgangs im payment.instruments Array zurückgegeben wird.

{
  "id": string,
  "handler_id": string,
  "type": string,
  "selected": boolean,
  "display": {
    "brand": string,
    "last_digits": string,
    "description": string,
    "card_art": string
  },
  "billing_address": {
    "first_name": string,
    "last_name": string,
    "street_address": string,
    "extended_address": string,
    "address_locality": string,
    "address_region": string,
    "postal_code": string,
    "address_country": string,
    "phone_number": string
  },
  "credential": {
    "type": "PAYMENT_GATEWAY" | "DIRECT",
    "token": string
  }
}

Properties

Attribut	Typ	Immer vorhanden?	Beschreibung
id	String	Ja	Eine eindeutige Kennung für diese Zahlungsmittelinstanz, die von der Plattform zugewiesen wird.
handler_id	String	Ja	Die eindeutige Kennung für die Handler-Instanz, die dieses Zahlungsmittel erstellt hat. Entspricht dem Feld id in der Konfiguration des Zahlungsmittel-Handlers.
type	String	Ja	Der Typ des Zahlungsmittels, z.B. card.
selected	Boolean	Nein	Gibt an, ob dieses Zahlungsmittel vom Nutzer ausgewählt wurde.
display	Objekt	Ja	Anzeigeinformationen für das Zahlungsmittel.
display.brand	String	Ja	Die Kartenmarke bzw. das Kartennetzwerk (z. B. „VISA“).
display.last_digits	String	Ja	Die letzten vier Ziffern der Kartennummer.
display.description	String	Nein	Eine für Nutzer sichtbare Beschreibung der Karte.
display.card_art	String	Nein	Ein URI zu einem Bild, das die Karte darstellt.
billing_address	Objekt	Nein	Die mit der Karte verknüpfte Rechnungsadresse. Wird nur zurückgegeben, wenn billing_address_required in der Konfiguration auf true gesetzt wurde.
billing_address.first_name	String	Nein	Der Vorname des Kontakts, der mit der Adresse verknüpft ist.
billing_address.last_name	String	Nein	Der Nachname des Kontakts, der mit der Adresse verknüpft ist.
billing_address.street_address	String	Nein	Die Adresse.
billing_address.extended_address	String	Nein	Eine Adresserweiterung (z. B. Haus- oder Wohnungsnummer).
billing_address.address_locality	String	Nein	Der Ort (z. B. die Stadt).
billing_address.address_region	String	Nein	Die Region (z. B. das Bundesland).
billing_address.postal_code	String	Nein	Die Postleitzahl.
billing_address.address_country	String	Nein	Der Ländercode (2-Buchstaben-Format nach ISO 3166-1 alpha-2).
billing_address.phone_number	String	Nein	Die Telefonnummer. Wird nur zurückgegeben, wenn phone_number_required in der Konfiguration auf true gesetzt wurde.
credential	Objekt	Nein	Die sicheren Tokenisierungsdaten, die von Google Pay zurückgegeben werden.
credential.type	String	Ja	Der Tokenisierungstyp. Entspricht dem konfigurierten Typ. PAYMENT_GATEWAY: Wird verwendet, wenn Sie Zahlungen über ein unterstütztes Gateway verarbeiten. DIRECT: Wird verwendet, wenn Sie Anmeldedaten selbst entschlüsseln.
credential.token	String	Ja	Das verschlüsselte Token für die Zahlungsanmeldedaten als JSON-serialisierter String. Bei PAYMENT_GATEWAY enthält dies die verschlüsselte Nutzlast, die an Ihr Gateway übergeben werden muss. Bei DIRECT enthält dies die verschlüsselten Kartendetails (die mit Ihrem privaten Schlüssel entschlüsselt werden müssen). Weitere Informationen zum Format und zum Entschlüsselungsprozess finden Sie im Leitfaden zur Kryptografie von Zahlungsdaten.