# Use Cases für erweiterte Antworten

Erweitern Sie die API-Antworten, um allgemeine Zahlungsdetails zurückzugeben.

Verwenden Sie den Parameter `expand` in Ihrer API-Anfrage, um Details abzurufen, die die API in ihrer Standardantwort nicht zurückgibt. Die folgenden Anwendungsszenarien veranschaulichen dies anhand häufig angeforderter Informationen.

## Stripe-Gebühr für eine bestimmte Zahlung anzeigen

Sie können die Bearbeitungsgebühren einer Zahlung prüfen, nachdem die Zahlung verarbeitet wurde und Stripe die [Saldo-Transaktion](https://docs.stripe.com/api/balance_transactions/object.md#balance_transaction_object-fee_details) erstellt hat. Das Ereignis [charge.updated](https://docs.stripe.com/api/events/types.md#event_types-charge.updated) verweist auf die Eigenschaft `balance_transaction` (zum Beispiel `txn_123`) und zeigt an, dass sie einsatzbereit ist.

Anstatt die Saldotransaktion separat zu suchen, können Sie sie mit `expand` in einem einzigen Anruf abrufen.

> *IC±Nutzer/innen* (A pricing plan where businesses pay the variable network cost for each transaction plus the Stripe fee rather than a flat rate for all transactions. This pricing model provides more visibility into payments costs) können keine Informationen zu Zahlungsgebühren aus der Saldo-Transaktion abrufen. Verwenden Sie stattdessen den Zahlungsgebührenbericht.

#### Curl

```bash
curl https://api.stripe.com/v1/payment_intents/pi_1Gpl8kLHughnNhxyIb1RvRTu \
  -u <<YOUR_SECRET_KEY>>: \-d "expand[]"="latest_charge.balance_transaction" \
  -G
```

Nutzer/innen mit API-Version [2022-08-01](https://docs.stripe.com/upgrades.md#2022-08-01) oder älter:

#### Curl

```bash
curl https://api.stripe.com/v1/payment_intents/pi_1Gpl8kLHughnNhxyIb1RvRTu \
  -u <<YOUR_SECRET_KEY>>: \-d "expand[]"="charges.data.balance_transaction" \
  -G
```

> Ein PaymentIntent muss [erfasst](https://docs.stripe.com/payments/place-a-hold-on-a-payment-method.md#capture-funds) werden und einen [Status](https://docs.stripe.com/api/payment_intents/object.md#payment_intent_object-status) von `succeeded` haben, damit die Stripe-Transaktionsgebühren verfügbar sind.

Bei Verwendung von `automatic_async` (dem Standard der `capture_method` seit Version `2024-04-10`) werden Saldo-Transaktionen erstellt, nachdem die Zahlung erfolgreich war, jedoch asynchron im Hintergrund. Das bedeutet:

- Das Feld `balance_transaction` im Zahlungsobjekt könnte unmittelbar nach der Bestätigung `null` sein.
- Wenn Sie `balance_transaction` oder `latest_charge.balance_transaction` erweitern, könnte es in der Antwort noch nicht verfügbar sein.
- Sie können auf das Ereignis `charge.updated` warten, um zu wissen, wann die Saldo-Transaktion verfügbar wird

Dieses asynchrone Verhalten verbessert die Zahlungsleistung, erfordert jedoch, dass Ihre Integration die Möglichkeit berücksichtigt, dass die Saldo-Transaktion möglicherweise nicht sofort verfügbar ist.

## In einer Auszahlung enthaltene Gebühren anzeigen

Jede automatische *Auszahlung* (A payout is the transfer of funds to an external account, usually a bank account, in the form of a deposit) ist an historische Änderungen des Saldos Ihres Stripe-Kontos gebunden. Die API zeichnet diese historischen Änderungen als [Saldo-Transaktionen](https://docs.stripe.com/api/balance_transactions/object.md) auf, die Sie mit [Saldo-Transaktionen auflisten](https://docs.stripe.com/api/balance_transactions/list.md) abrufen können. Aus einer Liste von Saldo-Transaktionen können Sie die Eigenschaft [source](https://docs.stripe.com/api/balance_transactions/object.md#balance_transaction_object-source) erweitern, um Informationen darüber zu erhalten, was die Änderung des Kontosaldos ausgelöst hat (Zahlung, Erstattung, Überweisung usw.). Zum Beispiel:

#### Curl

```bash
curl https://api.stripe.com/v1/balance_transactions \
  -u <<YOUR_SECRET_KEY>>: \
  -d payout=po_1Gl3ZLLHughnNhxyDrOia0vI \
  -d type=charge \-d "expand[]"="data.source" \
  -G
```

> Sie können den Saldo-Transaktionsverlauf nur bei *automatischen* Auszahlungen abrufen. Wenn Sie manuelle Auszahlungen aktiviert haben, müssen Sie den Transaktionsverlauf selbst verfolgen.

Weitere Infos [zum Auszahlungsabgleich](https://docs.stripe.com/payouts/reconciliation.md).

Wenn Sie *Connect* (Connect is Stripe's solution for multi-party businesses, such as marketplace or software platforms, to route payments between sellers, customers, and other recipients) mit Zielgebühren verwenden, können Sie die gleichen Informationen im Namen Ihrer verbundenen Konten abrufen. Ein Unterschied besteht darin, dass Zielgebühren sowohl eine Überweisung als auch eine verknüpfte Zahlung (in Form eines Charge-Objekts) beinhalten, um Mittel auf ein verbundenes Konto zu verschieben. Bei der Auflistung der Saldo-Transaktionen, die in den Auszahlungen Ihres verbundenen Kontos gebündelt sind, ist die Quelle jeder Saldo-Transaktion also mit der Zahlung der Überweisung verknüpft und nicht mit der Ursprungsgebühr. Um die verursachende Gebühr abzurufen, müssen Sie die verknüpfte Überweisung einer Zahlung über die Eigenschaft [source_transfer](https://docs.stripe.com/api/charges/object.md#charge_object-source_transfer) erweitern und von dort aus müssen Sie die Eigenschaft [source_transaction](https://docs.stripe.com/api/transfers/object.md#transfer_object-source_transaction) der Überweisung erweitern:

#### Curl

```bash
curl https://api.stripe.com/v1/balance_transactions \
  -u <<YOUR_SECRET_KEY>>: \
  -d payout=po_1G7bnaD2wdkPsFGzdVOqU44u \
  -d type=payment \-d "expand[]"="data.source.source_transfer.source_transaction" \
  -H "Stripe-Account: acct_1G7PaoD2wdkPsFGz" \
  -G
```