> ## Documentation Index
> Fetch the complete documentation index at: https://docs.swipelux.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Empfänger und Ziele

> Erstellen Sie einen Drittparteien-Empfänger und den Bank- oder Wallet-Endpunkt, der einen Payout empfängt.

Verwenden Sie ein Kundenkonto, wenn dem Kunden der Endpunkt gehört. Verwenden Sie einen Empfänger und ein Ziel, wenn eine andere Person oder ein anderes Unternehmen die Gelder empfängt.

Der Empfänger dokumentiert, wer Gelder empfängt. Das Ziel dokumentiert, wo sie sie empfangen.

## 1. Empfänger anlegen

Legen Sie eine Einzelperson oder ein Unternehmen mit [`POST /v3/customers/{customerId}/recipients`](/api-reference/recipients/post-v3-customers-by-customer-id-recipients) an. Senden Sie diese Header:

```http theme={null}
X-API-Key: ${SWIPELUX_API_KEY}
Idempotency-Key: recipient-create-001
Content-Type: application/json
```

```json theme={null}
{
  "type": "individual",
  "relationship": "contractor",
  "firstName": "Jason",
  "lastName": "Swipelux",
  "email": "jason@swipelux.com",
  "phone": "+14155551234",
  "address": {
    "streetLine1": "1 Market Street",
    "city": "San Francisco",
    "state": "CA",
    "postalCode": "94105",
    "country": "US"
  },
  "label": "Jason contractor"
}
```

Fügen Sie die Adresse hinzu, bevor Sie ein Fiat-Ziel anlegen. Speichern Sie die zurückgegebene Empfänger-`data.id` als `RECIPIENT_ID` und behalten Sie ihren aktuellen Status.

## 2. Ein Ziel hinzufügen

Legen Sie den Endpunkt mit [`POST /v3/customers/{customerId}/recipients/{recipientId}/destinations`](/api-reference/recipients/post-v3-customers-by-customer-id-recipients-by-recipient-id-destinations) an. Verwenden Sie einen neuen Schlüssel für dieses beabsichtigte Ziel:

```http theme={null}
X-API-Key: ${SWIPELUX_API_KEY}
Idempotency-Key: recipient-destination-create-001
Content-Type: application/json
```

<Tabs>
  <Tab title="Bank-Ziel">
    ```json theme={null}
    {
      "type": "ach",
      "currency": "USD",
      "details": {
        "routingNumber": "021000021",
        "accountNumber": "123456789",
        "accountType": "checking",
        "bankName": "Example Bank",
        "accountHolderName": "Jason Swipelux",
        "country": "US"
      }
    }
    ```
  </Tab>

  <Tab title="Wallet-Ziel">
    ```json theme={null}
    {
      "type": "wallet",
      "currency": "USDC",
      "ownership": {
        "type": "self_custodied"
      },
      "details": {
        "network": "base",
        "address": "0x1111111111111111111111111111111111111111"
      }
    }
    ```
  </Tab>
</Tabs>

Verwenden Sie `self_custodied` nur, wenn der Empfänger die Wallet kontrolliert. Folgen Sie der aktuellen API-Referenz-Variante, wenn die Wallet von einem anderen Verwahrer gehalten wird.

Speichern Sie die zurückgegebene Ziel-`data.id` als `DESTINATION_ID` und behalten Sie ihren aktuellen Status.

## 3. Auf Zielbereitschaft warten

Lesen Sie [`GET /v3/customers/{customerId}/recipients/{recipientId}/destinations/{destinationId}`](/api-reference/recipients/get-v3-customers-by-customer-id-recipients-by-recipient-id-destinations-by-destination-id), bevor Sie ein Quote erstellen.

Fahren Sie nur fort, wenn der aktuelle Zielstatus den Payout erlaubt und seine Währung, Methode und Netzwerk mit der beabsichtigten Bewegung übereinstimmen. Empfänger- und Zielstatus sind unabhängig voneinander.

Verwenden Sie die `dst_`-Ziel-ID im Payout-Quote. Die `rcp_`-Empfänger-ID identifiziert den Eigentümer-Datensatz und ist keine Quote-Ziel.

Nehmen Sie als Nächstes das bereite Ziel zu [Gelder senden](/de/integration/send-funds).


## Related topics

- [Migration zu v3](/de/api-reference/versioning/migrate-to-v3.md)
- [Gelder senden](/de/integration/send-funds.md)
- [Go-Live](/de/integration/go-live.md)
- [Konten und Wallets](/de/integration/accounts.md)
- [Häufige Abläufe](/de/integration/common-flows.md)