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

# Integraatiot

> Yhdistä TWICE ulkoisiin järjestelmiin API-avaimilla, webhookeilla ja tilitunnuksellasi.

<Frame caption="Asetukset > Integraatiot">
  <img src="https://mintcdn.com/twicecommerce/lZhc_tO8u1u_bL0Q/images/settings-integrations.webp?fit=max&auto=format&n=lZhc_tO8u1u_bL0Q&q=85&s=40fdc769db7318c16cae719abf0e7dd0" alt="Integraatioasetukset hallinnassa" width="1920" height="1080" data-path="images/settings-integrations.webp" />
</Frame>

## Määritelmä

<Snippet file="definitions/fi/integrations-definition.mdx" />

**Asetukset > Integraatiot** -sivulla kytket TWICEn muuhun järjestelmäympäristöösi. Se näyttää tunnisteen, tunnistetiedot ja webhook-päätepisteet, joita ulkoiset järjestelmät tarvitsevat lukeakseen TWICEstä tai lähettääkseen sinne dataa.

## Mitä hallinnassa on

| Ominaisuus     | Tyyppi              | Mitä se tekee                                                                                                                 |
| :------------- | :------------------ | :---------------------------------------------------------------------------------------------------------------------------- |
| **Account ID** | Tunniste            | Näyttää kauppias- eli tenant-tunnuksesi. Ulkoiset järjestelmät kohdistavat sillä API-kutsut ja webhook-hyötykuormat tilillesi |
| **API Keys**   | Tunnistautuminen    | Luo ja kumoa avaimia, joilla kutsutaan TWICEn hallinnan API:a                                                                 |
| **Webhooks**   | Lähtevät tapahtumat | Tilaa HTTPS-päätepisteeseen TWICEn lähettämät tilaustapahtumat                                                                |

Maksupalveluntarjoajat määritetään erikseen kohdassa [Asetukset → Maksut](/docs/fi/settings/payments), ei täällä.

## Account ID

Jokainen API-kutsu ja webhook-hyötykuorma viittaa **kauppiastunnukseesi** (tenant-tunniste). Account ID -kortti näyttää sen ja tarjoaa yhden napsautuksen kopioinnin. Jaa se kumppanille tai kehittäjälle, joka rakentaa integraatiota tiliäsi vasten.

## API-avaimet

API-avaimet tunnistavat kutsut TWICEn hallinnan API:iin.

* Luo avain **Create key** -toiminnolla — koko avain näytetään kerran.
* Jokaisesta avaimesta näkyy sen nimi, luontiaika ja luonut käyttäjä.
* Avaimen voi kumota milloin tahansa — kumoaminen astuu voimaan välittömästi.
* API-avaimella tehdyt kutsut kirjautuvat kyseiselle avaimelle [tapahtumalokiin](/docs/fi/concepts/admin/activity-logs) (tekijä näkyy muodossa `API: <label>`).

<Warning>
  API-avaimet antavat pääsyn koko tiliin — avainkohtaisia oikeusrajauksia ei ole. Käsittele niitä kuin salasanoja äläkä koskaan tallenna niitä versionhallintaan.
</Warning>

Käyttö ja kutsurajat on kuvattu sivulla [API-avaimet](/docs/fi/concepts/integrations/api-keys).

## Webhookit

Webhookit lähettävät tapahtumia TWICEstä järjestelmiisi lähes reaaliajassa. Jokaisella tilauksella on:

| Ominaisuus     | Tyyppi             | Kuvaus                                      |
| :------------- | :----------------- | :------------------------------------------ |
| **URL**        | HTTPS-päätepiste   | Minne hyötykuorma lähetetään POST-pyyntönä  |
| **Event type** | Yksi tapahtumanimi | Se yksi tapahtuma, joka laukaisee webhookin |
| **Status**     | Enum               | Onko tilaus aktiivinen vai poissa käytöstä  |

Yksi tilaus kuuntelee tasan yhtä tapahtumatyyppiä ja koskee koko tiliä — luo yksi tilaus kutakin haluamaasi tapahtumaa kohden. Tällä hetkellä lähetetään tilauksen elinkaaritapahtumat: `order.created`, `order.updated` ja `order.deleted`. Hyötykuorman muoto on kuvattu sivulla [Webhookit](/docs/fi/concepts/integrations/webhooks).

<Note>
  Webhookit edellyttävät niitä sisältävää pakettia — muut tilit näkevät päivityskehotteen. Katso [paketit](/docs/fi/twice-commerce-overview).
</Note>

## Miten integraatiodata liikkuu

```mermaid theme={null}
flowchart LR
    External[Ulkoinen järjestelmä]
    API[TWICEn hallinnan API]
    Core[TWICE Core]
    Webhook[Webhook-tilaus]

    External -->|Tunnistautuu API-avaimella| API
    API --> Core
    Core -->|Lähettää tapahtuman| Webhook
    Webhook -->|HTTPS POST| External
```

Saapuvat pyynnöt tunnistautuvat API-avaimella; lähtevät tapahtumat kulkevat webhookeina. Kauppiastunnus rajaa molemmat suunnat tilillesi.

## Aiheeseen liittyvät

<CardGroup cols={2}>
  <Card title="API-avaimet" icon="key" href="/docs/fi/concepts/integrations/api-keys">
    Tunnistaudu ja kutsu hallinnan API:a
  </Card>

  <Card title="Webhookit" icon="webhook" href="/docs/fi/concepts/integrations/webhooks">
    Tilaa tapahtumia
  </Card>
</CardGroup>