# Auszahlungsabgleich

Wissen, welche Transaktionen in einer bestimmten Auszahlung enthalten sind.

Wenn Sie Gelder von Ihrem verfügbaren Stripe-Saldo an Ihr Bankkonto senden, wird ein Auszahlungsobjekt generiert. Automatische Auszahlungen erfolgen routinemäßig entsprechend Ihrem [Auszahlungsplan](https://docs.stripe.com/payouts.md#payout-schedule) und können Gelder aus mehreren Transaktionen umfassen.

Stripe bietet die folgenden Möglichkeiten, die in einer automatischen Auszahlung enthaltenen Transaktionen zu überprüfen:

- Öffnen Sie eine Auszahlung im [Stripe-Dashboard](https://dashboard.stripe.com/test/payouts).
- Zeigen Sie den [Bericht zum Auszahlungsabgleich an](https://docs.stripe.com/reports/payout-reconciliation.md) oder laden Sie ihn herunter.
- Rufen Sie die Auszahlungsdetails über die Stripe-API ab, wie in diesem Leitfaden dokumentiert.

> #### Abgleich für manuelle Auszahlungen
> 
> Sie steuern den Zeitpunkt und die Höhe der manuellen Auszahlungen, sodass Stripe nicht erkennen kann, welche Transaktionen in jeder Auszahlung enthalten sind. Sie sind dafür verantwortlich, die von Ihnen erstellten Auszahlungen mit Ihrem Transaktionsverlauf abzugleichen.

## Auszahlungs-ID suchen

Sie benötigen die `id` einer Auszahlung (`po_xxx`), um Informationen zu den Transaktionen der Auszahlung abzurufen. So erhalten Sie sie:

- Überwachen Sie das Webhook-Ereignis `payout.reconciliation_completed`.
- Rufen Sie [Auszahlungen auflisten](https://docs.stripe.com/api/payouts/list.md) auf, um eine Liste mit Auszahlungen zu überprüfen.
- Rufen Sie sie aus Ihrer eigenen Datenbank ab.

Sie können die [Auszahlung abrufen](https://docs.stripe.com/api/payouts/retrieve.md), um auf ihre Eigenschaften zuzugreifen. Dies gilt jedoch nicht für die einzelnen Transaktionen, aus denen sich der Gesamtbetrag zusammensetzt.

```json
{
  "id": "po_001",
  "amount": 8000,
  "currency": "usd",
  "status": "paid",
  ...
}
```

## BalanceTransactions auflisten

Jede Geldbewegung in oder aus Ihrem Stripe-Konto erstellt eine [BalanceTransaction](https://docs.stripe.com/api/balance_transactions.md). Geben Sie die Auszahlungs-ID in Ihrer [BalanceTransaction-Liste](https://docs.stripe.com/api/balance_transactions/list.md) an, um die Ergebnisse nur nach Transaktionen zu filtern, die mit dieser Auszahlung verknüpft sind.

```curl
curl -G https://api.stripe.com/v1/balance_transactions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d payout=po_xxx
```

Wenn Sie mehr Ergebnisse als die standardmäßigen 10 benötigen, setzen Sie den Parameter [`limit`](https://docs.stripe.com/api/balance_transactions/list.md#balance_transaction_list-limit) in der Anfrage oder verwenden Sie die [Automatische Paginierung](https://docs.stripe.com/api/pagination/auto.md) von Stripe.

Die Antwort gibt ein Array von BalanceTransactions-Objekten für die angegebene Auszahlung zurück:

```json
{
  "object": "list",
  "data": [
    {
      "id": "txn_001",
      "amount": 10000,
      "type": "charge",
      "source": "ch_001",
      ...
    },
    {
      "id": "txn_002",
      "amount": -2000,
      "type": "refund",
      "source": "re_001",
      ...
    },
    ...
```

Die Eigenschaft `type` gibt die zugrunde liegende Aktivität an, die die Transaktion erzeugt hat. Beispiel:

- `charge`: Eine Zahlung von Ihrem Kunden/Ihrer Kundin.
- `refund`: Rückerstattungen, die Sie an Ihre Kundinnen/Kunden zurückgesendet haben.
- `stripe_fee`: Eine von Ihnen bezahlte Stripe-Gebühr.
- `payout`: Die Auszahlung selbst, bei der es sich auch um eine Transaktion handelt, mit der Gelder von Ihrem Stripe-Konto zu Ihrem Bankkonto bewegt wurden.

Eine vollständige Liste finden Sie unter [Arten von Saldo-Transaktionen](https://docs.stripe.com/reports/balance-transaction-types.md#types).

## Saldo der Transaktionsressourcen erweitern

Die `source`-Eigenschaft jeder BalanceTransaction gibt das zugrunde liegende Objekt an, das den Transaktionstyp darstellt, beispielsweise `ch_xxx` für eine Zahlung oder `re_xxx` für eine Rückerstattung. Um diese Objekte abzurufen, ohne zusätzliche API-Aufrufe durchzuführen, aktualisieren Sie den vorherigen Code mithilfe von [expand](https://docs.stripe.com/expand.md).

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

Die Antwort enthält das erweiterte `source`-Objekt für jede BalanceTransaction in der Auszahlung:

```json
{
  "object": "list",
  "data": [
    {
      "id": "txn_001",
      "amount": 10000,
      "type": "charge",
      "source": {
        "id": "ch_001",
        "amount": 10000,
        "metadata": { ... },
        ...
      },
      ...
    },
    {
      "id": "txn_002",
      "amount": -2000,
      "type": "refund",
      "source": {
        "id": "re_001",
        "amount": 2000,
        "reason": "requested_by_customer",
        ...
      },
      ...
```

Verwenden Sie den folgenden Code, um auf die Eigenschaften des `source`-Objekts wie `id` und `amount` zuzugreifen.

#### Ruby

```ruby
balance_transactions['data'].each do |txn|
  obj = txn['source']
  puts "#{obj['id']} #{obj['amount']}"
end
```