# Umstellung auf die neuesten flexiblen Zahlungsszenarien

Passen Sie Ihre erweiterten Beta-Zahlungsszenarien an die allgemeine Version an.

Stripe unterstützt jetzt mehrere flexible Zahlungsszenarien für Transaktionen ohne Karte. Wenn Sie die private Beta-Version einer dieser Funktionen bereits integriert haben, finden Sie in diesem Leitfaden Details zum Upgrade auf die allgemeine Version. Informationen zu neuen Integrationen finden Sie in den folgenden Leitfäden für die Funktionen, die Sie interessieren:

- [Eine Autorisierung schrittweise erhöhen](https://docs.stripe.com/payments/incremental-authorization.md)
- [Mehr als den autorisierten Betrag erfassen](https://docs.stripe.com/payments/overcapture.md)
- [Online-Kartenzahlung länger zurückhalten](https://docs.stripe.com/payments/extended-authorization.md)
- [Eine Zahlung mehrmals erfassen](https://docs.stripe.com/payments/multicapture.md)

Wir haben die folgenden auf Feedback basierenden Verbesserungen an diesen Funktionen vorgenommen:

- Detaillierte Kontrolle über die Funktionen auf der Ebene des *PaymentIntent* (API object that represents your intent to collect payment from a customer, tracking charge attempts and payment state changes throughout the process).
- Klarere Erwartungen in Bezug auf die Verfügbarkeit und Nutzung von Funktionen nach einer *Bestätigung* (Confirming a PaymentIntent indicates that the customer intends to pay with the current or provided payment method. Upon confirmation, the PaymentIntent attempts to initiate a payment)sphase.

Für jede der flexiblen Zahlungsfunktionen gelten andere Anforderungen als für die Private Beta-Integration. Wählen Sie die Funktion aus, die Sie aktualisieren möchten, und lesen Sie den Hinweis oben bezüglich der Änderungen und Anforderungen, die für diese Funktion gelten.

# Inkrementelle Autorisierung

> This is a Inkrementelle Autorisierung for when flex-payment-features is incremental-auth. View the full page at https://docs.stripe.com/payments/flexible-features-migration?flex-payment-features=incremental-auth.

> #### Änderungen gegenüber der Beta
> 
> Der erste Schritt dieser Integration ist jetzt obligatorisch.

## Inkrementeller Autorisierung anfordern

Ihr *PaymentIntent* (API object that represents your intent to collect payment from a customer, tracking charge attempts and payment state changes throughout the process) muss vor der Bestätigung eine Aufforderung zur inkrementellen Autorisierung enthalten.

> Dieser vormals optionale Schritt ist jetzt obligatorisch.

### Before

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]=card" \
  -d payment_method=pm_card_debit_incrementalAuthAuthorized \
  -d confirm=true \
  -d capture_method=manual \
  -d "expand[]=latest_charge" \
  -d "payment_method_options[card][request_incremental_authorization_support]=true"
```

### After

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]=card" \
  -d payment_method=pm_card_debit_incrementalAuthAuthorized \
  -d confirm=true \
  -d capture_method=manual \
  -d "expand[]=latest_charge" \
  -d "payment_method_options[card][request_incremental_authorization]=if_available"
```

Die Antwort gibt jetzt den Status der inkrementellen Autorisierungsanfrage in der Eigenschaft `payment_method_details.card.incremental_authorization.status` der [latest_charge](https://docs.stripe.com/api/charges/object.md) zurück. Der Statuswert ist `available` oder `unavailable` je nach Zahlungsmethode des Kunden/der Kundin.

### Before

```json
// PaymentIntent Response
{
  "id": "pi_ANipwO3zNfjeWODtRPIg",
  "object": "payment_intent",
  "amount": 1000,
  "amount_capturable": 1000,
  "amount_received": 0,
  ...
  // if latest_charge is expanded
  {
    "latest_charge": {
        "amount": 1000,
        "payment_method_details": {
          "card": {"incremental_authorization_supported": true // or false
          }
        }
        ...
      }
  }
}
```

### After

```json
// PaymentIntent Response
{
  "id": "pi_ANipwO3zNfjeWODtRPIg",
  "object": "payment_intent",
  "amount": 1000,
  "amount_capturable": 1000,
  "amount_received": 0,
  ...
  // if latest_charge is expanded
  {
    "latest_charge": {
        "amount": 1000,
        "payment_method_details": {
          "card": {
            "incremental_authorization": {"status": "available" // or "unavailable"
            }
          }
        }
        ...
      }
  }
}
```

## Autorisierten Betrag schrittweise ändern

**Im Vergleich zur Beta-Version wurden an diesem Schritt keine Änderungen vorgenommen.**

```curl
curl https://api.stripe.com/v1/payment_intents/pi_ANipwO3zNfjeWODtRPIg/increment_authorization \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1500
```


# Übererfassung

> This is a Übererfassung for when flex-payment-features is overcapture. View the full page at https://docs.stripe.com/payments/flexible-features-migration?flex-payment-features=overcapture.

> #### Änderungen gegenüber der Beta
> 
> Der erste Schritt dieser Integration existierte zuvor nicht, ist aber jetzt verpflichtend.

## Übererfassung anfordern

Ihr *PaymentIntent* (API object that represents your intent to collect payment from a customer, tracking charge attempts and payment state changes throughout the process) musseine Anfrage zur Übererfassung vor der Bestätigung enthalten. Die Private Beta-Integration für die Übererfassung enthielt diesen Schritt nicht, da der Anfrageparameter nicht existierte.

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]=card" \
  -d payment_method=pm_card_visa \
  -d confirm=true \
  -d capture_method=manual \
  -d "expand[]=latest_charge" \
  -d "payment_method_options[card][request_overcapture]=if_available"
```

Die Antwort gibt den Status der Übererfassungsanfrage in der Eigenschaft `payment_method_details.card.overcapture.status` der [latest_charge](https://docs.stripe.com/api/charges/object.md) zurück. Der Statuswert ist `available` oder `unavailable` je nach Zahlungsmethode des Kunden/der Kundin.

```json
// PaymentIntent Response
{
  "id": "pi_ANipwO3zNfjeWODtRPIg",
  "object": "payment_intent",
  "amount": 1000,
  "amount_capturable": 1000,
  "amount_received": 0,
  ...
  // if latest_charge is expanded
  {
    "latest_charge": {
        "amount": 1000,
        "payment_method_details": {
          "card": {
            "overcapture": {"status": "available", // or "unavailable"
                "maximum_capturable_amount": 1200
            }
          }
        }
        ...
      }
  }
}
```

## Einen höheren Betrag als den autorisierten Betrag erfassen

Wenn Sie einen Betrag für einen *PaymentIntent* (API object that represents your intent to collect payment from a customer, tracking charge attempts and payment state changes throughout the process) erfassen möchten, der über dem autorisierten Betrag liegt, verwenden Sie den [capture](https://docs.stripe.com/api/payment_intents/capture.md)-Endpoint und geben einen [amount_to_capture](https://docs.stripe.com/api/payment_intents/capture.md#capture_payment_intent-amount_to_capture)-Wert bis zu [maximum_amount_capturable](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details-card-overcapture) an.

```curl
curl https://api.stripe.com/v1/payment_intents/pi_ANipwO3zNfjeWODtRPIg/capture \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount_to_capture=1200
```


# Erweiterte Autorisierung

> This is a Erweiterte Autorisierung for when flex-payment-features is extended-auth. View the full page at https://docs.stripe.com/payments/flexible-features-migration?flex-payment-features=extended-auth.

> #### Änderungen gegenüber der Beta
> 
> Der erste Schritt dieser Integration existierte zuvor nicht, ist aber jetzt verpflichtend.

## Erweiterte Autorisierung anfordern

Ihr *PaymentIntent* (API object that represents your intent to collect payment from a customer, tracking charge attempts and payment state changes throughout the process) muss eine Aufforderung zur erweiterten Autorisierung vor der Bestätigung enthalten. Die Private Beta-Integration für die erweiterte Autorisierung beinhaltete diesen Schritt nicht, da der Anfrageparameter nicht existierte.

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]=card" \
  -d payment_method=pm_card_visa \
  -d confirm=true \
  -d capture_method=manual \
  -d "expand[]=latest_charge" \
  -d "payment_method_options[card][request_extended_authorization]=if_available"
```

Die Antwort gibt jetzt den Status der erweiterten Autorisierungsanfrage in der Eigenschaft `payment_method_details.card.extended_authorization.status` der [latest_charge](https://docs.stripe.com/api/charges/object.md) zurück. Der Statuswert ist `available` oder `unavailable` je nach Zahlungsmethode des Kunden/der Kundin.

```json
// PaymentIntent Response
{
  "id": "pi_ANipwO3zNfjeWODtRPIg",
  "object": "payment_intent",
  "amount": 1000,
  "amount_capturable": 1000,
  "amount_received": 0,
  ...
  // if latest_charge is expanded
  {
    "latest_charge": {
        "amount": 1000,
        "payment_method_details": {
          "card": {// The field is now always available, even when not using extended authorization
            "capture_before": 1679090539,
            // The response contains information on whether the capture window was extended.
            "extended_authorization": {"status": "enabled", // or "disabled"
            }
          }
        }
        ...
      }
  }
}
```

## Autorisierung erfassen

**Im Vergleich zur Beta-Version wurden an diesem Schritt keine Änderungen vorgenommen.**

Führen Sie eine Erfassung vor dem im Feld [`capture_before`](https://docs.stripe.com/api/charges/object.md#charge_object-payment_method_details-card-capture_before) angegebenen Datum durch.

```curl
curl https://api.stripe.com/v1/payment_intents/pi_ANipwO3zNfjeWODtRPIg/capture \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount_to_capture=1000
```


# Multicapture

> This is a Multicapture for when flex-payment-features is multicapture. View the full page at https://docs.stripe.com/payments/flexible-features-migration?flex-payment-features=multicapture.

> #### Änderungen gegenüber der Beta
> 
> Für die Migration von der Beta-Version auf die allgemein verfügbare Version sind mehrere Änderungen erforderlich, die sich auf alle vier nachfolgenden Schritte auswirken.

## Multicapture anfordern

Ihr *PaymentIntent* (API object that represents your intent to collect payment from a customer, tracking charge attempts and payment state changes throughout the process) muss eine Anfrage zur Mehrfacherfassung vor der Bestätigung enthalten. Die Private Beta-Integration für Multicapture beinhaltete diesen Schritt nicht, da der Anfrageparameter nicht existierte.

Fordern Sie den Zugriff auf die Funktion in der allgemein verfügbaren Version an, indem Sie den Wert `multicapture_migrate_to_ga_from_beta` im [Stripe-Version](https://docs.stripe.com/sdks/set-version.md)-Header übergeben, bevor Sie den *PaymentIntent* (API object that represents your intent to collect payment from a customer, tracking charge attempts and payment state changes throughout the process) bestätigen.

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-04-22.preview; multicapture_migrate_to_ga_from_beta" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]=card" \
  -d payment_method=pm_card_visa \
  -d confirm=true \
  -d capture_method=manual \
  -d "expand[]=latest_charge" \
  -d "payment_method_options[card][request_multicapture]=if_available"
```

Die Antwort gibt den Status der Multicapture-Anfrage in der Eigenschaft `payment_method_details.card.multicapture.status` der [latest_charge](https://docs.stripe.com/api/charges/object.md) zurück. Der Statuswert ist `available` oder `unavailable` je nach Zahlungsmethode des Kunden/der Kundin.

```json
// PaymentIntent Response
{
  "id": "pi_ANipwO3zNfjeWODtRPIg",
  "object": "payment_intent","amount": 1000,
  "amount_capturable": 1000,
  "amount_received": 0,
  ...
  // if latest_charge is expanded
  "latest_charge": {"amount": 1000,
      "amount_captured": 0,
      "amount_refunded": 0,
      "payment_method_details": {
        "card": {
          "multicapture": {"status": "available" // or "unavailable"
          }
        }
      }
      ...
    }
  ...
}
```

## Autorisierten Betrag mehrfach teilweise erfassen

Ähnlich wie bei der Beta-Version können Sie mit dem optionalen Parameter `final_capture` den *PaymentIntent* (API object that represents your intent to collect payment from a customer, tracking charge attempts and payment state changes throughout the process) mehrmals erfassen, solange er sich im [Zustand requires_capture](https://docs.stripe.com/payments/paymentintents/lifecycle.md) befindet.

```curl
curl https://api.stripe.com/v1/payment_intents/pi_ANipwO3zNfjeWODtRPIg/capture \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2026-04-22.preview; multicapture_migrate_to_ga_from_beta" \
  -d amount_to_capture=700 \
  -d final_capture=false \
  -d "expand[]=latest_charge"
```

```json
// PaymentIntent Response
{
  "id": "pi_ANipwO3zNfjeWODtRPIg",
  "object": "payment_intent","amount": 1000,
  "amount_capturable": 300, // 1000 - 700 = 300
  "amount_received": 700,
  "status": "requires_capture",
  // if latest_charge is expanded
  "latest_charge": {"amount": 1000,
      "amount_captured": 700,
      "amount_refunded": 0,
      ...
    }
  ...
}
```

> In der allgemein verfügbaren Version führt der Versuch, den gesamten verbleibenden Betrag zu erfassen, wenn der Parameter `final_capture` auf `false` gesetzt ist, zu einem 400-Fehler.

### Before

```curl
curl https://api.stripe.com/v1/payment_intents/pi_ANipwO3zNfjeWODtRPIg/capture \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount_to_capture=300 \
  -d final_capture=false \
  -d "expand[]=latest_charge"
```

```json
// PaymentIntent Response
{
  "id": "pi_ANipwO3zNfjeWODtRPIg",
  "object": "payment_intent","amount": 1000,
  "amount_capturable": 0, // 1000 - 700 - 300 = 0
  "amount_received": 1000,
  "status": "succeeded",
  // if latest_charge is expanded
  "latest_charge": {"amount": 1000,
      "amount_captured": 1000,
      "amount_refunded": 0,
      ...
    }
  ...
}
```

### After

```curl
curl https://api.stripe.com/v1/payment_intents/pi_ANipwO3zNfjeWODtRPIg/capture \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount_to_capture=300 \
  -d final_capture=false \
  -d "expand[]=latest_charge"
```

```json
// HTTP 400
{
  "message": "can't set final_capture as false when fully capturing a payment intent.",
  "type": "invalid_request_error"
}
```

## Webhooks

Die Generierung des Multicapture-Ereignisses unterscheidet sich von der Beta-Version, der Inhalt der Ereignisse ist jedoch unverändert.

| Verhalten                             | Vorher                                                                                                   | Nachher                                                                                                  |
| ------------------------------------- | -------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| Bei jeder nicht endgültigen Erfassung | Stripe sendet [charge.captured](https://docs.stripe.com/api/events/types.md#event_types-charge.captured) | Stripe sendet [charge.updated](https://docs.stripe.com/api/events/types.md#event_types-charge.updated)   |
| Bei der endgültigen Erfassung         | Stripe sendet [charge.captured](https://docs.stripe.com/api/events/types.md#event_types-charge.captured) | Stripe sendet [charge.captured](https://docs.stripe.com/api/events/types.md#event_types-charge.captured) |

## Rückerstattung

In der allgemein verfügbaren Version wird keine [Rückerstattung](https://docs.stripe.com/api/refunds/object.md) erstellt, um nicht erfasste Gelder für einen beliebigen *PaymentIntent* (API object that represents your intent to collect payment from a customer, tracking charge attempts and payment state changes throughout the process) darzustellen, bei dem der/die Nutzer/in `final_capture=true` übergibt.


## Wählen Sie aus, wie Sie mehr als den ursprünglich autorisierten Betrag erfassen möchten

Zwei der flexiblen Zahlungsfunktionen ermöglichen es Ihnen, einen höheren als den ursprünglich autorisierten Betrag zu erfassen:

- Übererfassung bis zu einem bestimmten Limit ([Mehr als den autorisierten Betrag einer Zahlung erfassen](https://docs.stripe.com/payments/overcapture.md))
- Erhöhen Sie die bestehende Autorisierung und erfassen Sie dann den neu autorisierten Betrag ([Autorisierung erhöhen](https://docs.stripe.com/payments/incremental-authorization.md))

Das folgende Beispiel zeigt, wie sich diese Funktionen in der allgemein verfügbaren Version ergänzen können.

```curl
curl https://api.stripe.com/v1/payment_intents \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d amount=1000 \
  -d currency=usd \
  -d "payment_method_types[]=card" \
  -d payment_method=pm_card_visa \
  -d confirm=true \
  -d capture_method=manual \
  -d "expand[]=latest_charge" \
  -d "payment_method_options[card][request_incremental_authorization]=if_available" \
  -d "payment_method_options[card][request_overcapture]=if_available"
```

```json
// PaymentIntent Response
{
  "object": "payment_intent",
  "amount": 1000,
  ...
  // if latest_charge is expanded
  {
    "latest_charge": {
      "payment_method_details": {
        "card": {
          "incremental_authorization": {"status": "available" // or "unavailable"
          },
          "overcapture": {"status": "available", // or "unavailable"
              "maximum_capturable_amount": 1200
          }
        }
      }
      ...
    }
  }
}
```

Wenn beide Funktionen verfügbar sind, haben Sie nach der*Bestätigung* (Confirming a PaymentIntent indicates that the customer intends to pay with the current or provided payment method. Upon confirmation, the PaymentIntent attempts to initiate a payment) des PaymentIntent bei den nächsten Schritten die Möglichkeit, einen höheren als den ursprünglich autorisierten Betrag zu erfassen:

1. Führen Sie eine Übererfassung durch, wenn der gewünschte Betrag kleiner oder gleich dem `maximum_capturable_amount` ist.
1. Führen Sie eine inkrementelle Autorisierung bis zum gewünschten Betrag durch und führen Sie dann die Erfassung durch.