Inkrementelle Autorisierungen

Wenn Sie einen PaymentIntent erstellen, können Sie anfordern, dass die Zahlung schrittweise erfasst wird. Setzen Sie das Feld request_incremental_authorization_support auf true und capture_method auf manual. Dadurch wird der Text im Bildschirm des Zahlungseinzugs von Total auf Pre-authorization aktualisiert.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]"=card_present \
  -d capture_method=manual \
  -d "payment_method_options[card_present][request_incremental_authorization_support]"=true

Überprüfen Sie das Feld incremental_authorization_supported in der Bestätigungsantwort, um festzustellen, ob der PaymentIntent für eine inkrementelle Autorisierung infrage kommt.

Sie können nach der Bestätigung nur inkrementelle Autorisierungen für nicht erfasste Zahlungen durchführen. Um den Betrag einer Zahlung vor der Bestätigung anzupassen, verwenden Sie stattdessen die Methode zum Aktualisieren.

async () => {
  const result = await terminal.processPayment(paymentIntent);
  if (result.error) {
    // Placeholder for handling result.error
  } else if (result.paymentIntent) {
    // Now you're ready to increment the authorization using your backend
  }
}

Verwenden Sie den Endpoint increment_authorization, um den autorisierten Betrag für ein Payment Intent zu erhöhen, und geben Sie den aktualisierten Betrag auf den erhöht werden soll, an. Dieser muss größer als der ursprünglich autorisierte Betrag sein. Dadurch wird versucht, die Differenz zwischen dem vorherigen und dem erhöhten Betrag zu autorisieren. Jeder PaymentIntent kann höchstens 10 inkrementelle Autorisierungsversuche durchlaufen, einschließlich Ablehnungen.

Ein einzelner PaymentIntent kann diesen Endpoint mehrmals aufrufen, um den autorisierten Betrag weiter zu erhöhen.

curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/increment_authorization \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=1500

Eine Autorisierung kann entweder:

• Erfolgreich sein – Der PaymentIntent mit dem aktualisierten Betrag wird zurückgegeben.
• Fehler – Gibt den Fehler card_declined zurück und der PaymentIntent bleibt zum Erfassen des ursprünglichen Betrags autorisiert. Aktualisierungen an anderen PaymentIntent-Feldern (z. B. application_fee_amount) werden nicht gespeichert.

Um den autorisierten Betrag für einen PaymentIntent mit vorherigen inkrementellen Autorisierungen zu erfassen, verwenden Sie den Endpoint capture. Um den autorisierten Betrag zu erhöhen und gleichzeitig diesen aktualisierten Betrag zu erfassen, geben Sie einen aktualisierten amount_to_capture an.

Bei Angabe eines amount_to_capture-Werts, der höher ist als der derzeit autorisierte Betrag, kommt es nicht zu einem automatischen inkrementellen Autorisierungsversuch.

curl https://api.stripe.com/v1/payment_intents/{{PAYMENT_INTENT_ID}}/capture \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount_to_capture=2000

Ein inkrementeller Autorisierungsversuch kann folgendermaßen ausgehen:

• Erfolgreich sein – Der captured PaymentIntent mit dem aktualisierten Betrag wird zurückgegeben.
• Fehler – Gibt den Fehler card_declined zurück und der PaymentIntent bleibt zum Erfassen des ursprünglichen Betrags autorisiert. Aktualisierungen an anderen PaymentIntent-Feldern (z. B. application_fee_amount) werden nicht gespeichert.

Dennoch empfehlen wir, bei der Verwendung von amount_to_capture immer auf mögliche Fehler zu prüfen.