Teilautorisierung

So lassen Sie Teilzahlungen für Kartentransaktionen zu.

Verwenden Sie Teilautorisierungen, um die Genehmigung für einen Teil des ursprünglich angeforderten Betrags für eine Kartentransaktion anzufordern, wenn das verfügbare Guthaben nicht ausreicht, um den vollen Betrag abzudecken. Auf diese Weise können Ihre Kundinnen und Kunden das verfügbare Guthaben auf ihrer Karte (z. B. einer Debitkarte) verwenden und dann eine alternative Zahlungsmethode zur Bezahlung des Restbetrags nutzen.

Bevor Sie loslegen

Entscheiden Sie zunächst, wie Sie mit dem Teil des ursprünglich angeforderten Betrags umgehen möchten, der nicht durch die Teilautorisierung abgedeckt ist. Sie können einen separaten PaymentIntent für eine andere Zahlungsart erstellen, den gesamten PaymentIntent stornieren oder nur den teilweise autorisierten Betrag erfassen. Stellen Sie sicher, dass Sie Ihren Kundinnen/Kunden klar und deutlich mitteilen, wie Sie mit der Transaktion fortfahren möchten und welche möglichen Auswirkungen dies auf sie haben könnte.

Compliance

Sie sind für die Einhaltung aller geltenden Gesetze, Vorschriften und Netzwerkregeln verantwortlich, wenn Sie Teilautorisierungen nutzen. Informieren Sie sich über die Regeln der Kartennetze, mit denen Sie diese Funktion nutzen möchten, um sicherzustellen, dass Ihre Verkäufe allen geltenden Regeln entsprechen, die je nach Netzwerk unterschiedlich sind. Beispielsweise beschränkt American Express ab Mai 2024 die Nutzung der Funktion auf Debit- und Prepaid-Karten und lässt ihre Verwendung nicht für wiederkehrende oder grenzüberschreitende Transaktionen zu, während Visa die Nutzung der Funktion für alle Kartentypen vorschreibt. Die auf dieser Seite bereitgestellten Informationen im Zusammenhang mit der Einhaltung dieser Anforderungen dienen Ihrer allgemeinen Orientierung und stellen keine rechtliche, steuerliche, buchhalterische oder sonstige fachliche Beratung dar. Wenden Sie sich an eine Fachperson, wenn Sie sich bezüglich Ihrer Verpflichtungen unsicher sind.

Verfügbarkeit

IC+-Funktion

Mit den IC±Preisen können Sie auf Teilautorisierungen zugreifen. Wenden Sie sich an Ihren Vertriebsmitarbeiter oder an den Support, um diese Funktion zu aktivieren.

Teilautorisierungen unterliegen folgenden Einschränkungen:

Sie können Teilautorisierungen nur für Online-Kartenzahlungen verwenden.
Nur Visa, Mastercard, Discover und Amex unterstützen Teilautorisierungen.
Der Aussteller und der Kartentyp bestimmen, ob sie unterstützt werden.
Wenn ein Transaktionsbetrag teilweise autorisiert wurde, können Sie mit der Übererfassung aufgrund von Netzwerkeinschränkungen keine Beträge erfassen, die über dem autorisierten Betrag liegen.
Wenn Sie Zahlungen im Auftrag Ihres Connect-Kontos mithilfe eines transfer_amount abwickeln, beschränkt Stripe diese auf den teilweise autorisierten Betrag, wenn der transfer_amount größer als der teilweise autorisierte Betrag ist.
Stripe erzwingt einen Mindestzahlungsbetrag für teilweise autorisierte Zahlungen und lehnt jeden geringen PaymentIntent ab.

Manuelle Erfassung zum Erstellen und Bestätigen von PaymentIntents verwenden

Um eine Teilautorisierung für bestimmte PaymentIntents zu aktivieren, setzen Sie if_available auf den Parameter request_partial_authorization.

Teilautorisierungsstatus verifizieren

Überprüfen Sie das Feld payment_method_details im latest_charge in der Bestätigungsantwort des PaymentIntent, um festzustellen, ob die Netzwerke eine Teilautorisierung für die Zahlung angewendet haben:

partial_authorization.status: Zeigt einen der folgenden Autorisierungsstatus an: partially_authorized, fully_authorized, declined oder not_requested.
amount_requested: Bestätigt Ihren ursprünglich angegebenen Anforderungsbetrag.
amount_authorized: Legt den autorisierten Betrag fest.

Die folgende Beispielantwort zeigt, dass die Transaktion teilweise für 70 USD autorisiert wurde, was weniger als die ursprünglich angeforderten 100 USD ist.

Example PaymentIntent confirmation response
{
  "id": "pi_foo",
  "amount": 7000,
  "amount_capturable": 7000,
  "amount_received": 0,
  "capture_method": "manual",
  ...
  // if latest_charge is expanded
  "latest_charge": {
    "id": "ch_foo",
    "object": "charge",
    "amount": 7000,
    "captured": false,
    "payment_method_details": {
      "card": {
        "amount_authorized": 7000,
        "amount_requested": 10000,
        "partial_authorization": {
          "status": "partially_authorized",
        }
      }
    }
  },
  ...
  "status": "requires_capture"
}

Lehnt der/die Kartenaussteller/in die Autorisierung ab, gibt diese Antwort einen Fehler des Typs card_declined zurück.

Teilweise autorisierten PaymentIntent erfassen

Sie können einen autorisierten PaymentIntent bis zu dem Betrag (oder amount_capturable) erfassen, der in der Bestätigungsantwort zurückgegeben wird.

Eine erfolgreiche Erfassung gibt das PaymentIntent-Objekt mit aktualisierten Feldern zurück:

Successful capture response
{
  "id": "pi_foo",
  "amount": 7000,
  "amount_capturable": 0,
  "amount_received": 7000,
  "capture_method": "manual",
  "latest_charge": "ch_foo",
  ...
  "status": "succeeded",
}

OptionalAutomatische Erfassung zum Bestätigen und Erfassen eines PaymentIntent verwenden

Wir empfehlen, die Teilautorisierung mit der manuellen Erfassung zu verwenden, da Sie so den teilweise autorisierten Betrag auswerten und entscheiden können, ob mit der Erfassung fortgefahren werden soll. Sie können jedoch auch eine Teilautorisierung mit automatischer Erfassung verwenden. Wenn Sie sich entscheiden, diese Option zu verwenden, gehen Sie mit Bedacht vor. Es ist möglich, dass Sie einen unzureichenden Betrag erfassen.

Sie können eine teilweise Autorisierung mit der automatischen Erfassung aktivieren, indem Sie Folgendes festlegen:

request_partial_authorization auf if_available
Erfassungsmethode auf automatic (oder leer lassen)

Bei der automatischen Erfassung wird Ihre Transaktion automatisch erfasst, auch wenn sie nur teilweise autorisiert ist. Die folgende Beispielantwort zeigt, dass die Transaktion teilweise autorisiert und für 70 USD erfasst wurde, weniger als die vollen angeforderten 100 USD.

Successful capture response
{
  "id": "pi_foo",
  "amount": 7000,
  "amount_capturable": 0,
  "amount_received": 7000,
  "capture_method": "automatic",
  ...
  // if latest_charge is expanded
  "latest_charge": {
    "id": "ch_foo",
    "object": "charge",
    "amount": 7000,
    "amount_captured": 7000,
    "captured": true,
    "payment_method_details": {
      "card": {
        "amount_authorized": 7000,
        "amount_requested": 10000,
        "partial_authorization": {
          "status": "partially_authorized",
        }
      }
    }
  },
  ...
  "status": "succeeded"
}

OptionalInkrement mit Teilautorisierung

Sie können eine Teilautorisierung im Autorisierungsaufruf für das PaymentIntent-Inkrement anfordern, um eine Genehmigung für einen Teil des angeforderten Inkrementbetrags zu erhalten, wenn das verfügbare Guthaben nicht ausreicht, um den vollen Betrag abzudecken.

PaymentIntent erstellen und bestätigen

Erstellen und bestätigen Sie einen PaymentIntent, bei dem die inkrementelle Autorisierung mit dem Parameter request_incremental_authorization aktiviert ist. Dadurch wird die Funktion für inkrementelle Autorisierung für den PaymentIntent aktiviert. Weitere Informationen finden Sie unter inkrementelle Autorisierung.

Die folgende Beispielantwort zeigt, dass die Transaktion für 100 USD vollständig autorisiert ist:

Example PaymentIntent confirmation response
{
  "id": "pi_foo",
  "amount": 10000,
  "amount_capturable": 10000,
  "amount_received": 0,
  "capture_method": "manual",
  ...
  // if latest_charge is expanded
  "latest_charge": {
    "id": "ch_foo",
    "object": "charge",
    "amount": 10000,
    "captured": false,
    "payment_method_details": {
      "card": {
        "amount_authorized": 10000,
        "amount_requested": 10000,
        "partial_authorization": {
          "status": "not_requested",
        },
        "incremental_authorization": {
          "status": "available"
        }
      }
    }
  },
  ...
  "status": "requires_capture"
}

Teilautorisierung bei Inkrement aktivieren

Um eine Teilautorisierung für Inkremente zu aktivieren, legen Sie request_partial_authorization auf if_available fest:

Standardmäßig behält Stripe den Opt-in-Parameter für request_partial_authorization bei, den Sie bei der PaymentIntent-Bestätigung für Inkremente übergeben. Um Teilautorisierungen für Inkremente bei einem PaymentIntent zu deaktivieren, der sich für eine Teilautorisierung entschieden hat, legen Sie payment_method_options[card][request_partial_authorization] auf never fest.

In dem Beispiel wird angefordert, den PaymentIntent von 100 USD auf 150 USD zu erhöhen, dieser ist jedoch nur teilweise auf 135 USD autorisiert.

Command Line
curl https://api.stripe.com/v1/payment_intents/pi_foo/increment_authorization \
  -usk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "amount"=15000 \
  -d "payment_method_options[card][request_partial_authorization]"="if_available" \
  -d "expand[]"="latest_charge"

Die folgende Beispielantwort zeigt das aktuelle Charge-Objekt, das mit dem teilweise autorisierten PaymentIntent-Objekt verknüpft ist:

Successful increment response
{
  "id": "pi_foo",
  "amount": 13500,
  "amount_capturable": 13500,
  "amount_received": 0,
  "capture_method": "manual",
  ...
  // if latest_charge is expanded
  "latest_charge": {
    "id": "ch_foo",
    "object": "charge",
    "amount": 13500,
    "captured": false,
    "payment_method_details": {
      "card": {
        "amount_authorized": 13500,
        "amount_requested": 15000,
        "partial_authorization": {
          "status": "partially_authorized",
        }
      }
    }
  },
  ...
  "status": "requires_capture"
}

Ihre Integration testen

Um beim Testen eine Teilautorisierung auszulösen, verwenden Sie die Stripe-Testkarte für die Teilautorisierung mit beliebiger Prüfziffer (CVC), Postleitzahl und zukünftigem Ablaufdatum. Legen Sie request_partial_authorization unbedingt auf if_available fest, um eine Teilautorisierung mit der Testkarte auszulösen.

Testkartennummer	Zahlungsmethode	Beschreibung
	`pm_card_debit_partialAuthorization`	Mit dieser Karte werden 70 % des in der Bestätigungsanfrage angegebenen Betrags, der auf die nächstgelegene Einheit (z. B. Cent) gerundet wird, autorisiert, wobei eine Teilautorisierung angefordert wird. Andernfalls wird die Transaktion mit dem Fehlercode „Unzureichende Deckung“ abgelehnt.
	`pm_card_debit_partialIncrement`	Mit dieser Karte wird die ursprüngliche Autorisierung vollständig autorisiert. Für nachfolgende Inkremente autorisiert diese Karte 70 % des in der Inkrementanfrage angegebenen Betrags, der auf die nächstgelegene Einheit (z. B. Cent) gerundet wird, wobei eine Teilautorisierung angefordert wird. Andernfalls wird „Unzureichende Deckung“ zurückgegeben.