Dokumentation
Dokumentation
Token
Schliessen API Dokumentation
Token

A token allows to save payment information. It is practically a number (token reference) that represents this information and that the merchant can store. The token is initialized at the customer’s first payment and for the following ones an interaction is not necessary. A token is used for recurring payments. The set up of a token depends if the connector allows it. If the stored payment information is not valid anymore we ask the customer automatically.

Zustände
  • Erstellen
    Der Status Create zeigt an dass der Typ Token gerade erstellt wird.
  • Aktiv
    Der Status aktiv bedeutet, dass der Eintrag vom Typen 'Token' aktiv ist und genutzt werden kann.
  • Inaktiv
    Der Status Inaktiv zeigt dass der Eintrag vom Typen Token nicht genutzt wird.
  • Im Löschvorgang
    Der deleting Status bedeutet, dass der Eintrag vom Typen Token gerade im Prozess der Löschung ist.
  • Gelöscht
    Der Gelöschte-Status markeiert den Eintrag für die Löschung aus der Datenbank.
Eigenschaften
  • Erzeugt am
    Das Datum und die Uhrzeit, zu der das Objekt erstellt wurde.
  • Externe ID
    Eine vom Client generierte Nonce, die eine auszuführende Aktion eindeutig identifiziert. Nachfolgende Anfragen mit der gleichen externen ID führen die Aktion nicht erneut aus, sondern geben das ursprüngliche Ergebnis zurück.
  • Geplantes Löschdatum
    Das Datum und die Uhrzeit, zu der das Objekt endgültig entfernt werden soll. Wenn der Wert leer ist, wird das Objekt nicht entfernt.
  • ID
    A unique identifier for the object.
  • Kunden ID
    Die eindeutige Kennung des Kunden im externen System.
  • Kunden-E-Mail-Adresse
    Die E-Mail Adresse des Kunden.
  • One-Click-Payment aktivieren
    Ob das Token für One-Click-Zahlungen aktiviert ist, die den Zahlungsvorgang für den Kunden vereinfachen. One-Click-Tokens sind über die Kunden-ID mit Kunden verknüpft.
  • Referenzierte Space ID
    Die ID des Raums, zu dem dieses Objekt gehört.
  • Sprache
    The language that is linked to the object.
  • Status
    Der aktuelle Zustand des Objekts.

    A token can have the following states:

    Active

    When the state is set to Active this token is going to be used during the transaction.

    Inactive

    When the state is set to Inactive this token is not going to be used. However, all the information is not deleted and you can reactivate the token at any moment.

    Deleting

    The token is in the process of deletion. This may take some time until the token is marked as Deleting before being marked as Deleted.

    Deleted

    The token is deleted. Since the token is linked with data which cannot be deleted immediately, we need to keep it until all the data can be removed.

  • Token Referenz
    Die Referenz, die zur Identifizierung des Zahlungs-Tokens verwendet wird (z. B. die ID oder E-Mail-Adresse des Kunden).
  • Version
    The version is used for optimistic locking and incremented whenever the object is updated.
  • Zeitzone
    Die Zeitzone des Kunden, die sich darauf auswirkt, wie Daten und Zeiten bei der Kommunikation mit dem Kunden formatiert werden.