# Stebby (/fi/businesses/integrations/stebby)



<Callout type="error">
  **Tämä sivu on tarkoitettu vain liikuntapaikoille ja yrityksille.**

  Jos olet asiakas ja haluat maksaa Stebbyllä, sinun ei tarvitse tehdä mitään. Voit valita Stebbyn maksutavaksi kassalla, jos se on käytössä liikuntapaikallasi.

  Liikkujan ohjeet maksamiseen löydät sivulta [Maksaminen ja edut](/fi/consumers/payments).
</Callout>

<Callout type="info">
  **Stebby on saatavilla pyynnöstä.** Ota yhteyttä [Thrilin
  tukeen](mailto:support@thril.fi), niin otamme sen käyttöön liikuntapaikallasi.
</Callout>

Stebby on Viron ja Latvian työsuhde-etulompakko. Asiakkaat maksavat työnantajan tarjoamalla edulla ja omalla Stebby-saldollaan. Kun integraatio on aktiivinen, asiakkaat voivat valita Stebbyn kassalla verkossa ja Thril-sovelluksessa, hyväksyä maksun Stebbyssä ja palata Thriliin.

Integraatio on käytettävissä Viron ja Latvian liikuntapaikoissa.

## Edellytykset [#edellytykset]

Tarvitset Stebbyltä nämä:

* **Stebby-sopimus** liikuntapaikallesi ja sille Point of Sale.
* **Standard- tai Gold-paketti.** API-käyttö vaatii jommankumman.
* **API-avain** Point of Salellesi. Avaa Stebbyssä Point of Sale, aktivoi API-käyttö ja luo avain. Stebby neuvoo tässä [ohjekeskuksessaan](https://stebby-faq.helpscoutdocs.com/article/164-how-to-activate-api-and-addchange-the-codes-of-the-service-in-stebby).
* **Palvelu ja sille viitekoodi jokaiselle Stebby-kategorialle, jota myyt.** Lisää ne Point of Saleesi Stebbyssä. Palvelun kategoria ratkaisee, voiko työnantajan etu maksaa sen. Esimerkiksi kenttälajit ja kuntosali ovat eri kategoriassa kuin keilailu, sauna tai vuokravälineet.

Thril lähettää Stebbylle oman hintansa, joten palvelulle Stebbyssä asetetulla hinnalla ei ole merkitystä.

## Käyttöönotto [#käyttöönotto]

1. Siirry kohtaan **Asetukset → Järjestelmä → Integraatiot → Stebby**
2. Syötä **API-avain**. Thril hakee Point of Salesi palvelut Stebbystä.
3. Valitse **Oletus-Stebby-palvelu**
4. Valinnainen: valitse muita palveluita kohdissa **Eri palvelu tuotetyypeittäin** ja **Eri palvelu resursseittain**. Katso [Stebby-palvelut](#stebby-palvelut) alta.
5. Vaihda **Tila** **Aktiiviseksi** ja valitse **Tallenna muutokset**

Thril tarkistaa API-avaimen Stebbyltä, kun tallennat. Tallennuksen jälkeen avainta ei näytetä uudelleen. Kun muokkaat integraatiota myöhemmin, jätä kenttä tyhjäksi, niin nykyinen avain säilyy.

Asiakkaat voivat maksaa Stebbyllä vain tuotteita, jotka sallivat työsuhde-etumaksut. Ota tuotteilla käyttöön **Maksettavissa työsuhde-edulla** ja resursseilla **Oikeus maksaa työsuhde-edulla** niille, joita haluat myydä Stebbyllä.

## Stebby-palvelut [#stebby-palvelut]

Jokainen maksun rivi menee Stebbylle yhtenä ostona, jolla on Stebby-palvelu. Thril valitsee palvelun tässä järjestyksessä:

1. **Resurssi.** Varaukset resurssille, jolla on oma palvelu kohdassa **Eri palvelu resursseittain**, käyttävät sitä palvelua. Esimerkiksi padelhallin keilaradat kuuluvat eri Stebby-kategoriaan.
2. **Tuotetyyppi.** Kohdassa **Eri palvelu tuotetyypeittäin** valitun tuotetyypin rivit käyttävät sitä palvelua, esimerkiksi tapahtumat, jäsenyydet tai Pro Shop -tuotteet.
3. **Oletus.** Kaikki muu käyttää **Oletus-Stebby-palvelua**.

Valitset jokaisen palvelun nimellä Stebbyn antamasta listasta. Jos Stebby ei enää listaa tallentamaasi palvelua, asetussivulla näkyy varoitus **Stebby ei enää listaa joitakin tallennettuja palveluita**. Näiden rivien Stebby-maksut epäonnistuvat, kunnes valitset toisen palvelun.

## Maksut ja palautukset [#maksut-ja-palautukset]

* Asiakkaan Stebby-saldon täytyy kattaa koko summa. Jos se ei riitä, maksu epäonnistuu eikä Stebby veloita mitään. Asiakas voi valita toisen maksutavan.
* Palautus **Alkuperäiselle maksutavalle** menee takaisin asiakkaan Stebby-lompakkoon rivi kerrallaan. Stebby-palautuksista ei peritä palautusmaksua.
* Voit myös valita **Palauta krediitteinä** tai **Käsittele manuaalisesti**.
* Jos poistat integraation käytöstä, aiempien Stebby-maksujen palautukset menevät silti Stebbyyn.

## Vianmääritys [#vianmääritys]

* Jos **Aktiivinen**-valinta on harmaana, syötä **API-avain** ja valitse **Oletus-Stebby-palvelu**.
* Jos tallennus epäonnistuu viestillä "Stebby ei hyväksynyt API-avainta. Tarkista avain ja yritä uudelleen.", tarkista, että kopioit koko avaimen Stebbystä.
* Jos tallennus epäonnistuu viestillä "Tällä Stebby API -avaimella ei voi vastaanottaa verkkomaksuja.", pyydä Stebbyä ottamaan avaimelle käyttöön TOKEN-konteksti.
* Jos asiakkaat näkevät, ettei liikuntapaikka voi vastaanottaa Stebby-maksuja ostoksesta, tarkista, että rivin palvelu on yhä olemassa Stebbyssä ja että sillä on oikea viitekoodi.
* Integraation poistaminen käytöstä lopettaa välittömästi asiakkaiden mahdollisuuden maksaa Stebbyllä.
* Sopimukseen, pakettiin tai API-avaimeen liittyvissä kysymyksissä ota yhteyttä Stebbyyn. Integraatioon Thrilissä liittyvissä asioissa ota yhteyttä [Thrilin tukeen](mailto:support@thril.fi).