> ## 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.

# Gelder empfangen

> Erstellen Sie ein einmaliges Fiat-Pay-in und präsentieren Sie die genauen Finanzierungsanweisungen für diesen Transfer.

Verwenden Sie ein quotiertes Pay-in, wenn der Kunde einen bestimmten Betrag finanzieren muss. Der Transfer wickelt Stablecoins in eine ausgegebene Wallet ab.

```mermaid theme={null}
flowchart TD
  A["Ready pay-in capability"] --> B["Ready destination wallet"]
  B --> C["Create quote"]
  C --> D["Execute transfer"]
  D --> E["Display funding instructions"]
  E --> F["Track settlement"]
```

## Bevor Sie beginnen

Sie benötigen eine bereite Pay-in-Fähigkeit und eine bereite ausgegebene Ziel-Wallet für denselben Kunden. Erledigen Sie offene Arbeit über [Fähigkeiten und Aufgaben](/de/integration/onboarding/capabilities-and-requirements) und rufen Sie dann beide Ressourcen erneut ab.

## 1. Ein Quote erstellen

Erstellen Sie den Preis mit [`POST /v3/quotes`](/api-reference/money-movement/post-v3-quotes). Senden Sie diese Header:

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

```json theme={null}
{
  "customerId": "${CUSTOMER_ID}",
  "capabilityId": "${CAPABILITY_ID}",
  "externalId": "payin-order-123",
  "in": {
    "amount": "150.00",
    "currency": "USD"
  },
  "destinationId": "${SETTLEMENT_WALLET_ID}",
  "out": {
    "currency": "USDC"
  }
}
```

Speichern Sie `data.id` als `QUOTE_ID`. Präsentieren Sie die zurückgegebenen Beträge und Gebühren, statt sie aus dem Kurs neu zu berechnen.

## 2. Das Quote ausführen

Führen Sie das aktuelle Quote vor Ablauf mit [`POST /v3/transfers`](/api-reference/money-movement/post-v3-transfers) aus. Verwenden Sie einen neuen Schlüssel für diesen beabsichtigten Transfer:

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

```json theme={null}
{
  "quoteId": "${QUOTE_ID}"
}
```

Speichern Sie die Transfer-`data.id` als `TRANSFER_ID` und behalten Sie ihren aktuellen Zustand.

## 3. Finanzierungsanweisungen abrufen

Lesen Sie [`GET /v3/transfers/{transferId}/instructions`](/api-reference/money-movement/get-v3-transfers-by-transfer-id-instructions). Rendern Sie die zurückgegebene Variante `data.instructions`, ohne ihren Typ anzunehmen.

Diese Details sind transferspezifisch. Verwenden Sie niemals die Bankkoordinaten, den Code, die gehostete URL, den Betrag, die Referenz oder das Ablaufdatum eines Transfers für ein anderes Pay-in.

Wenn bei Bankanweisungen `reference.required` true ist, zeigen Sie den genauen `reference.value` neben den Bankkoordinaten an und machen Sie ihn kopierbar. Zeigen Sie den zurückgegebenen Betrag und die Währung aus demselben Anweisungssatz.

Ein ausgegebenes Bankkonto ist anders: Es liefert wiederverwendbare Daten für spätere Einzahlungen. Siehe [Bankkonto ausgeben](/de/integration/issue-bank-account), wenn dies das gewünschte Erlebnis ist.

## 4. Settlement verfolgen

Lesen Sie [`GET /v3/transfers/{transferId}`](/api-reference/money-movement/get-v3-transfers-by-transfer-id) nach der Ausführung und nach jedem Ereignis. Steuern Sie den kundenseitigen Status anhand des neuesten `data.state`.

Verwenden Sie `data.stateDetail` und `data.openTaskIds`, wenn der Transfer eine weitere Aktion benötigt. Markieren Sie ihn nicht anhand eines erwarteten Zeitplans als abgeschlossen.

Fügen Sie als Nächstes [Webhooks](/de/integration/webhooks) hinzu und halten Sie den Transferstatus synchronisiert, bis er ein Ergebnis erreicht, das Ihr Produkt verarbeitet.


## Related topics

- [Häufige Abläufe](/de/integration/common-flows.md)
- [Integrationsübersicht](/de/integration/overview.md)
- [Konten und Wallets](/de/integration/accounts.md)
- [Bankkonto ausgeben](/de/integration/issue-bank-account.md)
- [Rechtsgebietsrahmen](/de/knowledge-base/compliance/jurisdictions-and-availability.md)