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

# Pantit

> Miten TWICE varaa, veloittaa ja vapauttaa vuokrauksen pantteja.

<Frame caption="Tilaukset > [Tilaus] > Maksu — pantin pidätys">
  <img src="https://mintcdn.com/twicecommerce/J8PvWLtfo8Bk95ka/images/order-deposit-hold.webp?fit=max&auto=format&n=J8PvWLtfo8Bk95ka&q=85&s=1ae73dc126326cf2acb514886d9624cc" alt="Pantin pidätys tilauksen maksuvälilehdellä veloitus- ja vapautustoimintoineen" width="1920" height="1080" data-path="images/order-deposit-hold.webp" />
</Frame>

## Määritelmä

Pantti on summa, joka varataan kattamaan katoaminen tai vaurio vuokrauksen aikana. Kun asiakas maksaa kortilla, TWICE tekee pantista **pantin pidätyksen** — varat varataan mutta niitä ei veloiteta. Voit myöhemmin **veloittaa** varauksesta osan tai kaiken tai **vapauttaa** sen. Kun asiakas maksaa manuaalisella maksutavalla (maksu noudettaessa, mukautetut maksutavat), pantti kirjataan **manuaalisena panttina** ja sitä hallitaan maksupalveluntarjoajan ulkopuolella.

Pantin pidätys on erillinen vuokramaksusta. Vuokra maksetaan normaalisti; pantti on sen rinnalla omana Payment-objektinaan.

## Missä tätä käytetään?

* Vauriopantin varaaminen ennen vuokrauksen alkua
* Veloittaminen varauksesta, kun artikkeli palautetaan vaurioituneena tai myöhässä
* Varauksen vapauttaminen, kun artikkeli palautetaan hyvässä kunnossa

## Miten se toimii

Kun tilauksella on avoin pantti ja asiakas on maksanut kortilla, TWICE tekee pantin pidätyksen **off-session** (ilman asiakkaan läsnäoloa) tallennetulla kortilla.

### Automaattinen varausaikataulu

TWICE yrittää katevarausta automaattisesti vuokrauksen alkua lähestyttäessä ja toistaa yritystä säännöllisin väliajoin, kunnes se onnistuu tai varhaisin vuokrauksen aloituspäivä menee ohi.

### Varauksen tilat

| Tila         | Merkitys                                                                                                                                                       |
| :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Pending**  | Katevarausta ei ole vielä tehty. TWICE jatkaa yrittämistä, kunnes se onnistuu tai määräaika menee ohi.                                                         |
| **Reserved** | Pantin pidätys onnistui. Tietue säilytetään kirjausketjuna siitä, mitä varattiin ja milloin.                                                                   |
| **Expired**  | Määräaika (varhaisin vuokrauksen alku) meni ohi ennen kuin katevarausta ehdittiin tehdä.                                                                       |
| **Failed**   | TWICE lopetti yrittämisen muusta kuin aikaan liittyvästä syystä — esimerkiksi tallennettua korttia ei ole, kortti hylättiin toistuvasti tai tilaus suljettiin. |

### Pantin pidätyksen vanheneminen

Kun pantin pidätys onnistuu (tila: **Reserved**), maksupalveluntarjoaja pitää sen avoinna rajallisen ajan — Stripellä tyypillisesti noin 7 päivää. Jos et veloita tai vapauta varausta tämän ajan kuluessa, palveluntarjoaja peruu sen automaattisesti.

TWICE havaitsee tämän palveluntarjoajan webhookin kautta ja kirjaa varauksen tilaan **Expired** Maksut-välilehdellä. Tämä eroaa manuaalisesta vapautuksesta, joka näkyy tilana **Peruutettu**.

| Tila Maksut-välilehdellä | Syy                                                                                                      |
| :----------------------- | :------------------------------------------------------------------------------------------------------- |
| **Peruutettu**           | Vapautit pantin pidätyksen käsin ennen sen veloittamista.                                                |
| **Expired**              | Palveluntarjoaja perui veloittamattoman pantin pidätyksen automaattisesti sen voimassaoloajan päätyttyä. |

<Note>
  Varauksen tila **Expired** (yllä) ja maksun tila **Expired** ovat eri asioita. Varauksen tila tarkoittaa, että katevarausta ei koskaan tehty. Maksun tila tarkoittaa, että onnistunutta katevarausta ei veloitettu ajoissa ja palveluntarjoaja vapautti sen automaattisesti.
</Note>

Jos yrität veloittaa vanhentunutta katevarausta, TWICE palauttaa virheen. Jo vanhentuneen varauksen vapauttaminen täsmäyttää tietueen palveluntarjoajan tietoja vastaan — varoja ei liiku, koska varausta ei enää ole.

## Pantin hallinta

Tilauksen **Maksu**-välilehdeltä:

| Toiminto              | Mitä se tekee                                                                                                                                                                                                                                   |
| :-------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Reserve on demand** | Käynnistä pantin pidätys käsin sen sijaan, että odottaisit aikataulua. Kaksi tapaa: **card** (off-session-pantin pidätys tallennetulla kortilla) tai **manual** (kirjataan ilman maksupalveluntarjoajaa, käteis- tai ulkoisia pantteja varten). |
| **Capture**           | Veloita osa tai koko pantin pidätys. Voit lisätä syyn ja verorivit sekä halutessasi lähettää asiakkaalle sähköpostin.                                                                                                                           |
| **Release**           | Peru jäljellä oleva pantin pidätys ja palauta varat.                                                                                                                                                                                            |

## Tuetut maksupalveluntarjoajat

Korttipohjaiset pantin pidätykset toimivat palveluilla **Stripe** (kaikkien kauppojen käytettävissä) ja **Adyen** (käytössä vain valituilla kauppiailla). Ne palauttavat ensimmäisen onnistuneen veloituksen jälkeen uudelleenkäytettävän korttiviitteen, jotta pantin pidätys voidaan tehdä off-session.

Pantin sisältävät tilaukset voi maksaa myös manuaalisilla maksutavoilla (maksu noudettaessa, mukautetut maksutavat). Tällöin automaattista katevarausta ei tehdä — pantti kirjataan manuaalisena panttina ja hallitset sitä maksupalveluntarjoajan ulkopuolella (käteinen, henkilökortti, tilisiirto). Käytä näiden panttien kirjaamiseen toimintoa **Reserve on demand → manual**.

## Aiheeseen liittyvää

<CardGroup cols={2}>
  <Card title="Maksut" icon="receipt" href="/docs/fi/concepts/orders/payments">
    Maksujen hierarkia, tapahtumat ja hyvitykset.
  </Card>

  <Card title="Tilauksen elinkaari" icon="arrow-progress" href="/docs/fi/concepts/orders/order-lifecycle">
    Miten tilaukset etenevät keräilyn läpi.
  </Card>

  <Card title="Maksu-välilehti" icon="credit-card" href="/docs/fi/orders/order-tabs/payment">
    Hallitse tilauksen maksuja ja pantteja.
  </Card>

  <Card title="Maksuasetukset" icon="gear" href="/docs/fi/settings/payments">
    Yhdistä Stripe ja hallitse maksupalveluntarjoajia.
  </Card>
</CardGroup>
