# Fügt API-Fehlerdetails zu fehlgeschlagenen Aktionen von Terminal-Lesegeräten hinzu ## Das ändert sich Fügt der [action](https://docs.stripe.com/api/terminal/readers/object.md?api-version=2026-05-27.dahlia#terminal_reader_object-action) des Terminal-Lesegeräts für servergesteuerte Integrationen einen [api_error](https://docs.stripe.com/api/terminal/readers/object.md?api-version=2026-05-27.dahlia#terminal_reader_object-action-api_error)-Hash hinzu. Wenn eine Aktion auf dem Lesegerät aufgrund eines Stripe-API-Fehlers fehlschlägt, z. B. durch eine abgelehnte Kartenzahlung, enthält `api_error` die Fehlerwerte `type`, `code`, `message`, `decline_code`, `doc_url`, `request_log_url` und `param`. Wenn der Fehler vom Lesegerät selbst ausgeht, z. B. bei einem Abbruch durch die Kundin oder den Kunden, ist `api_error` null. Analysieren Sie `api_error.message` nicht für programmgesteuerte Logik; verwenden Sie stattdessen `type` oder `code`. Dafür ist die Lesegerät-Softwareversion 2.42 oder höher erforderlich. Auf älteren Lesegeräten ist `api_error` immer null. Weitere Unterstützung zur Integration finden Sie unter [Umgang mit fehlgeschlagenen Zahlungen](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=server-driven#payment-failures). ## Auswirkungen Sie können jetzt feststellen, ob das [Fehlschlagen einer Aktion eines servergesteuerten Lesegeräts](https://docs.stripe.com/terminal/payments/collect-card-payment.md?terminal-sdk-platform=server-driven#payment-failures) von der Stripe-API oder vom Lesegerät ausgeht. Außerdem können Sie bestimmen, welche Fehlermeldungen Karteninhaberinnen und -inhabern angezeigt werden sollen. Verwenden Sie [api_error.type](https://docs.stripe.com/api/terminal/readers/object.md?api-version=2026-05-27.dahlia#terminal_reader_object-action-api_error-type), um `card_error`-Fehler zu identifizieren, die Karteninhaberinnen und -inhabern angezeigt werden sollen. Verwenden Sie [api_error.doc_url](https://docs.stripe.com/api/terminal/readers/object.md?api-version=2026-05-27.dahlia#terminal_reader_object-action-api_error-doc_url) für Anleitungen zur Handhabung konkreter Fehlercodes. ## Änderungen #### REST API | Parameter | Change | Resources or endpoints | | --- | --- | --- | | `api_error` | Added | [Terminal.Reader.action](/api/terminal/readers/object?api-version=2026-05-27.dahlia#terminal_reader_object-action) | #### Ruby | Parameter | Change | Resources or methods | | --- | --- | --- | | `api_error` | Added | [Terminal::Reader::Action](/api/terminal/readers/object?api-version=2026-05-27.dahlia#terminal_reader_object-action) | #### Python | Parameter | Change | Resources or methods | | --- | --- | --- | | `api_error` | Added | [Terminal.Reader.Action](/api/terminal/readers/object?api-version=2026-05-27.dahlia#terminal_reader_object-action) | #### PHP | Parameter | Change | Resources or methods | | --- | --- | --- | | `api_error` | Added | [Terminal.Reader.action](/api/terminal/readers/object?api-version=2026-05-27.dahlia#terminal_reader_object-action) | #### Java | Parameter | Change | Resources or methods | | --- | --- | --- | | `apiError` | Added | [terminal.Reader.action](/api/terminal/readers/object?api-version=2026-05-27.dahlia#terminal_reader_object-action) | #### Node.js | Parameter | Change | Resources or methods | | --- | --- | --- | | `api_error` | Added | [Terminal.Reader.action](/api/terminal/readers/object?api-version=2026-05-27.dahlia#terminal_reader_object-action) | #### Go | Parameter | Change | Resources or methods | | --- | --- | --- | | `APIError` | Added | [TerminalReaderAction](/api/terminal/readers/object?api-version=2026-05-27.dahlia#terminal_reader_object-action) | #### .NET | Parameter | Change | Resources or methods | | --- | --- | --- | | `ApiError` | Added | [Terminal.Reader.Action](/api/terminal/readers/object?api-version=2026-05-27.dahlia#terminal_reader_object-action) | ## Upgrade #### REST API 1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an. 2. Wenn Sie ein SDK verwenden, aktualisieren Sie auf die entsprechende SDK-Version für diese API-Version. - Wenn Sie kein SDK verwenden, aktualisieren Sie Ihre [API-Anfragen](https://docs.stripe.com/api/versioning.md) auf `Stripe-Version: 2026-05-27.dahlia` 3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 6. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version). Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md). #### Ruby 1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an. 2. Aktualisieren Sie Ihr Ruby SDK auf die neueste Version. 3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 6. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version). Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md). #### Python 1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an. 2. Aktualisieren Sie Ihr Python SDK auf die neueste Version. 3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 6. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version). Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md). #### PHP 1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an. 2. Aktualisieren Sie Ihr PHP SDK auf die neueste Version. 3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 6. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version). Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md). #### Java 1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an. 2. Aktualisieren Sie Ihr Java SDK auf die neueste Version. 3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 6. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version). Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md). #### Node.js 1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an. 2. Aktualisieren Sie Ihr Node SDK auf die neueste Version. 3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 6. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version). Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md). #### Go 1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an. 2. Aktualisieren Sie Ihr Go SDK auf die neueste Version. 3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 6. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version). Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md). #### .NET 1. [Zeigen Sie Ihre aktuelle API-Version](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) in Workbench an. 2. Aktualisieren Sie Ihr .NET SDK auf die neueste Version. 3. Aktualisieren Sie die für [Webhook-Endpoints](https://docs.stripe.com/webhooks/versioning.md) verwendete API-Version. 4. [Testen Sie Ihre Integration](https://docs.stripe.com/testing.md) mit der neuen Version. 5. Wenn Sie Connect verwenden, [testen Sie Ihre Connect-Integration](https://docs.stripe.com/connect/testing.md). 6. Führen Sie das [Upgrade](https://docs.stripe.com/upgrades.md#perform-the-upgrade) in Workbench durch. Sie können [die Version für 72 Stunden zurücksetzen](https://docs.stripe.com/upgrades.md#roll-back-your-api-version). Erfahren Sie mehr über [Stripe-API-Upgrades](https://docs.stripe.com/upgrades.md). ## Zugehörige Änderungen - [Fügt Unterstützung für das Drucken von Bildern auf Terminal-Lesegeräten mit integrierten Druckern hinzu](https://docs.stripe.com/changelog/dahlia/2026-05-27/terminal-reader-print-action.md) - [Fügt Unterstützung für Gerätetypen von Verifone-Drittanbietern zu den Terminal-APIs hinzu](https://docs.stripe.com/changelog/dahlia/2026-05-27/verifone-third-party-device-types.md)