Verwenden von Zahlungsposten für flexible ZahlungenÖffentliche Vorschau

Erfahren Sie, wie Sie Zahlungsposten mit komplexen Zahlungen, wie Mehrfacherfassung und Übererfassung, verwenden können.

Sie können Posten für Zahlungen für komplexe Zahlungen verwenden, z.B. für Zahlungen mit Mehrfacherfassung und Übererfassung.

Multicapture

Sie können Zahlungsposten bei Mehrfacherfassungen verwenden.

Notiz

Mehrfacherfassung wird für Klarna oder PayPal nicht unterstützt.

Einen nicht erfassten PaymentIntent erstellen und bestätigen

Notiz

The API response doesn’t include line items by default. To return line items, expand amount_details.line_items.

Geben Sie bei der Erstellung des PaymentIntent die capture_method als manuell an und verwenden Sie den Parameter if_available, um Mehrfacherfassung für diese Zahlung anzufordern. Der erstellte PaymentIntent ermöglicht mehrere Erfassungen, sofern die Zahlungsmethode dies unterstützt.

In der Antwort enthält das Feld amount_details die in PaymentIntent angegebenen Einzelposten.

PaymentIntent erfassen

Sie können amount_details beim ersten Erfassen hinzufügen, auch wenn sie bei der Erstellung nicht angegeben wurden.
Wenn Sie bei der Erstellung amount_details angegeben haben, müssen Sie entweder amount_details übergeben oder sie bei der ersten Erfassung deaktivieren.

Dieselben Regeln gelten für amount_details [line_items] — Sie können sie beim ersten Erfassen hinzufügen, wenn Sie sie nicht bei der Erstellung angegeben haben, müssen sie jedoch einbeziehen oder explizit entfernen, falls sie bei der Erstellung vorhanden waren.

In der Antwort enthält das Feld amount_details die bei der ersten Erfassung angegebenen Einzelposten.

Der PaymentIntent verbleibt im Status requires_capture. An dieser Stelle können Sie entweder:

Erfassen Sie den PaymentIntent weiterhin mehrfach bis zum vollen Betrag des PaymentIntent.
Versetzen Sie PaymentIntent in den Status succeeded, indem Sie final_capture auf true setzen oder eine Erfassung ohne den final_capture-Parameter durchführen (weil final_capture standardmäßig auf true gesetzt ist).

Übererfassung

Sie können Zahlungsposten während Übererfassungen verwenden.

Einen nicht erfassten PaymentIntent erstellen und bestätigen

Notiz

The API response doesn’t include line items by default. To return line items, expand amount_details.line_items.

Geben Sie bei der Erstellung des PaymentIntent die capture_method als manuell an und verwenden Sie den Parameter if_available, um die Übererfassung für diese Zahlung anzufragen. Der erstellte PaymentIntent erlaubt die Übererfassung, wenn die Zahlungsmethode dies unterstützt.

In der Antwort enthält das Feld amount_details die in PaymentIntent angegebenen Einzelposten.

PaymentIntent erfassen

Um mehr als den aktuell autorisierten Betrag für einen PaymentIntent zu erfassen, verwenden Sie Endpunkt erfassen und geben einen amount_to_capture bis zum maximum_amount_capturable an.

Übergeben Sie bei der Erfassung einen aktualisierten amount_details Hash, der mit dem erfassten Betrag übereinstimmt.

In der Antwort enthält das Feld amount_details die Posten, die beim Erfassen angegeben wurden.

Inkrementelle Autorisierung

Sie können Zahlungsposten während der inkrementellen Autorisierung verwenden, um zusätzliche Beträge auf einem PaymentIntent nach der ursprünglichen Autorisierung zu autorisieren.

Einen nicht erfassten PaymentIntent erstellen und bestätigen

Notiz

The API response doesn’t include line items by default. To return line items, expand amount_details.line_items.

Geben Sie bei der Erstellung des PaymentIntent die capture_method als manual an und verwenden Sie den Parameter if_available, um eine inkrementelle Autorisierung für diese Zahlung anzufordern. Das erstellte PaymentIntent ermöglicht eine inkrementelle Autorisierung, wenn die Zahlungsmethode dies unterstützt.

In der Antwort enthält das Feld amount_details die in PaymentIntent angegebenen Einzelposten.

Autorisierung erhöhen

Um zusätzliche Beträge für ein PaymentIntent über den ursprünglich autorisierten Betrag hinaus zu autorisieren, verwenden Sie den increment_authorization-Endpoint und geben Sie einen Betrag bis zur maximal zulässigen inkrementellen Autorisierung der Zahlungsmethode an.

Übergeben Sie einen aktualisierten amount_details-Hash, der dem gesamten autorisierten Betrag nach der Erhöhung entspricht.

In der Antwort enthält das Feld amount_details die Posten, die während der inkrementellen Autorisierung angegeben wurden und der autorisierte Gesamtbetrag des PaymentIntent wird aktualisiert.