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

# Vastaanota varoja

> Luo kertaluontoinen fiat-maksun vastaanotto ja esitä tarkat rahoitusohjeet kyseiselle siirrolle.

Käytä tarjottua maksun vastaanottoa, kun asiakkaan täytyy rahoittaa tietty summa. Siirto selvittää vakaakolikon luotuun lompakkoon.

```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"]
```

## Ennen kuin aloitat

Tarvitset valmiin maksun vastaanotto -kyvyn ja valmiin luodun kohdelompakon samalle asiakkaalle. Suorita mahdollinen avoin työ [Kyvyt ja tehtävät](/fi/integration/onboarding/capabilities-and-requirements) -kautta, hae sitten molemmat resurssit uudelleen.

## 1. Luo tarjous

Luo hinta [`POST /v3/quotes`](/api-reference/money-movement/post-v3-quotes) -toiminnolla. Lähetä nämä otsakkeet:

```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"
  }
}
```

Tallenna `data.id` muuttujaan `QUOTE_ID`. Esitä palautetut summat ja maksut sen sijaan, että rakentaisit ne uudelleen kurssista.

## 2. Suorita tarjous

Suorita nykyinen tarjous ennen sen erääntymistä [`POST /v3/transfers`](/api-reference/money-movement/post-v3-transfers) -toiminnolla. Käytä uutta avainta tälle aiotulle siirrolle:

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

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

Tallenna siirron `data.id` muuttujaan `TRANSFER_ID` ja säilytä sen nykyinen tila.

## 3. Hae rahoitusohjeet

Lue [`GET /v3/transfers/{transferId}/instructions`](/api-reference/money-movement/get-v3-transfers-by-transfer-id-instructions). Renderöi palautettu `data.instructions`-muunnelma ilman, että oletat sen tyyppiä.

Nämä tiedot ovat siirtokohtaisia. Älä koskaan käytä yhden siirron pankkikoordinaatteja, koodia, isännöityä URL:iä, summaa, viitettä tai erääntymisaikaa toiseen maksun vastaanottoon.

Pankkiohjeiden osalta, kun `reference.required` on true, näytä tarkka `reference.value` pankkikoordinaattien vieressä ja tee siitä kopioitava. Näytä palautettu summa ja valuutta samasta ohjejoukosta.

Luotu pankkitili on erilainen: se tarjoaa uudelleenkäytettävät tiedot myöhempiä talletuksia varten. Katso [Luo pankkitili](/fi/integration/issue-bank-account), kun se on aiottu kokemus.

## 4. Seuraa selvitystä

Lue [`GET /v3/transfers/{transferId}`](/api-reference/money-movement/get-v3-transfers-by-transfer-id) suorituksen jälkeen ja jokaisen tapahtuman jälkeen. Aja asiakkaalle näkyvä tila uusimmasta `data.state`-arvosta.

Käytä `data.stateDetail`- ja `data.openTaskIds`-arvoja, kun siirto tarvitsee lisätoimia. Älä merkitse sitä valmiiksi odotetusta aikataulusta.

Seuraavaksi lisää [webhookit](/fi/integration/webhooks) ja pidä siirron tila synkronoituna, kunnes se saavuttaa tuloksen, jonka tuotteesi käsittelee.


## Related topics

- [Yleiset virrat](/fi/integration/common-flows.md)
- [Integraation yleiskuvaus](/fi/integration/overview.md)
- [Tilit ja lompakot](/fi/integration/accounts.md)
- [Luo pankkitili](/fi/integration/issue-bank-account.md)
- [Lainkäyttöalueiden kehys](/fi/knowledge-base/compliance/jurisdictions-and-availability.md)