Cost+Docs

Ein-Klick-Zahlungen (CIT)

Kundeninitiierte Ein-Klick-Zahlungen mit Karten-Tokenisierung aktivieren

Ein-Klick-Zahlungen ermöglichen es wiederkehrenden Kunden, mit einem einzigen Klick über eine zuvor gespeicherte Karte zu bezahlen. Dies ist ein Customer Initiated Transaction (CIT)-Ablauf, der Tokenisierung verwendet.

So funktioniert es

Der Ein-Klick-Ablauf besteht aus zwei Phasen:

  1. Erste Zahlung — Der Kunde bezahlt normal und Sie fordern einen Token für zukünftige Nutzung an
  2. Nachfolgende Zahlungen — Verwenden Sie den gespeicherten Token, um den Kunden mit einem Klick zu belasten

Phase 1: Erste Zahlung (Tokenisierung)

Erstellen Sie eine Bestellung mit one_click_type: "first" in der Transaktion, um die Tokenisierung anzufordern:

POST /v1/orders/
{
  "merchant_order_id": "first-order",
  "currency": "EUR",
  "amount": 1295,
  "return_url": "https://www.example.com",
  "transactions": [
    {
      "payment_method": "credit-card",
      "one_click_type": "first"
    }
  ]
}

Nach einer erfolgreichen Zahlung enthält die Antwort einen vault_token und eine first_transaction_id im Transaktionsobjekt. Speichern Sie diese Werte — Sie benötigen sie für zukünftige Ein-Klick-Zahlungen.

Response (transaction object)
{
  "payment_method": "credit-card",
  "payment_method_details": {
    "vault_token": "abc123-stored-token",
    "first_authorised_transaction_id": "txn_def456"
  }
}

Phase 2: Ein-Klick-Zahlung

Verwenden Sie den gespeicherten vault_token, um eine Ein-Klick-Zahlung zu erstellen:

POST /v1/orders/
{
  "merchant_order_id": "oneclick-order",
  "currency": "EUR",
  "amount": 995,
  "return_url": "https://www.example.com",
  "transactions": [
    {
      "payment_method": "credit-card",
      "one_click_type": "one-click",
      "vault_token": "{vault_token from phase 1}"
    }
  ]
}

Sie können entweder vault_token oder first_transaction_id verwenden, um auf die gespeicherte Karte zu verweisen. Beide funktionieren austauschbar.

CVC-Behandlung

CVC ist bei Ein-Klick-Zahlungen optional. Wenn Sie CVC für zusätzliche Sicherheit erheben möchten, fügen Sie es in die Transaktion ein:

{
  "payment_method": "credit-card",
  "one_click_type": "one-click",
  "vault_token": "{vault_token}",
  "cvc": "123"
}

Ein-Klick-Zahlungen sind kundeninitiiert (CIT). Für händlerinitiierte wiederkehrende Belastungen (MIT) siehe Wiederkehrende Zahlungen.

Verwandte Endpunkte

  • Bestellung erstellen — verwenden Sie one_click_type in der Transaktion, um Tokenisierung oder Ein-Klick-Zahlungen einzuleiten

On this page