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

# Stripe

> Vastaanota maksuja Macaly-projektissasi

Macalyn Stripe-integraation avulla voit vastaanottaa kertamaksuja ja toistuvia maksuja (tilauksia) suoraan projektissasi. Täysin toimiva testiympäristö luodaan automaattisesti, joten voit aloittaa rakentamisen ja testaamisen ilman Stripe-tiliä. Kun olet valmis siirtymään tuotantoon, yhdistä Stripe-tilisi ja vaihda live-tilaan.

<Callout icon="user">
  Käytettävissä [**Pro- ja Toimisto-paketeissa**](/docs/fi/welcome/pricing)
</Callout>

## Maksujen lisääminen projektiisi

Kuvaile maksutarpeesi agentille keskustelussa. Esimerkiksi:

```
Haluan myydä ihonhoitotuotteitani verkossa. Tarvitsen verkkokaupan,
jossa on tuoteluettelo ja kassa, jotta asiakkaat voivat maksaa kortilla.
```

```
Olen kirjoittanut e-kirjan ja haluan myydä sen hintaan $19. Tee sivu,
jolla ihmiset voivat maksaa ja ladata sen heti.
```

```
Aloitan kuukausittaisen verkkojoogakurssin hintaan $29/kk. Rakenna
laskeutumissivu, jolla jäsenet voivat ilmoittautua ja aloittaa tilauksensa.
```

Agentti luo projektisi täydellä maksuprosessilla ja määrittää Stripe-testiympäristön taustalla.

Voit lisätä maksut myös yläpalkin **Maksut**-välilehdeltä.

Voit aloittaa testaamisen heti Maksut-välilehdellä näkyvällä testikortilla:

| Kenttä | Arvo |
| - | - |
| Kortin numero | 4242 4242 4242 4242 |
| Voimassaolo | Mikä tahansa tuleva päivämäärä (esim. 01/30) |
| CVC | Mitkä tahansa 3 numeroa (esim. 111) |
| Postinumero | Mikä tahansa arvo (esim. 11000) |

Avaa projektisi, tee testiosto ja tarkista, miten kassa toimii.

<Tip>
  Voit testata myös virhetilanteita, kuten hylättyjä kortteja tai virheellisiä maksutietoja, Stripen omilla testikorteilla. Täydellisen luettelon testikorttinumeroista ja niiden simuloimista virheistä löydät [Stripen testausdokumentaatiosta](https://docs.stripe.com/testing#declined-payments).
</Tip>

## Suojatun testialueen aktivointi

Kun Macaly luo testiympäristösi, se luo Stripe-sandboxin. Sandbox toimii heti ja mahdollistaa maksujen testaamisen, mutta se ei ole yhdistetty mihinkään Stripe-tiliin. Lunastamattomat sandboxit vanhenevat 60 päivän kuluttua.

Lunastaminen yhdistää sandboxin Stripe-tiliisi. Lunastuksen jälkeen sandbox on sinun, ja voit hallita sitä suoraan Stripe Dashboardissa.

Sandboxin voi lunastaa kahdella tavalla: projektisi **Maksut**-välilehdeltä tai sähköpostin kautta, jonka Stripe lähettää sinulle testiympäristön luomisen jälkeen.

Lunastaminen on myös ensimmäinen askel kohti oikeiden maksujen vastaanottamista. Live-tilaan siirtyminen edellyttää, että lunastat sandboxin, vahvistat yrityksesi Stripessa ja syötät live-API-avaimesi.

<iframe src="https://www.youtube.com/embed/SVcTB6UZlIc" />

<Steps>
  <Step title="Avaa Maksut-välilehti">
    Avaa projektisi **Maksut**-välilehti. Otsikon "Aktivoi suojattu testialueesi" alla näkyy **Lunasta Stripe-sandboxisi** -painike.
  </Step>

  <Step title="Napsauta Lunasta Stripe-sandboxisi">
    Stripe avautuu uudelle välilehdelle, jossa on **Claim your sandbox** -sivu.

    Jos sinulla on jo Stripe-tili, valitse se luettelosta. Muussa tapauksessa napsauta **+ Create new account** ja luo tili ilmaiseksi.

    Jatka napsauttamalla **Continue**.
  </Step>

  <Step title="Anna yrityksesi tiedot">
    Stripe kysyy perustietoja:

    1. **Business name and location.** Anna yrityksesi nimi ja valitse maa. Napsauta **Continue**.
    2. **Business website and description.** Anna verkkosivustosi URL-osoite ja lyhyt kuvaus tuotteistasi tai palveluistasi. Tämän vaiheen voi ohittaa napsauttamalla **Skip**.
    3. **Intended use of Stripe.** Valitse yrityksellesi sopivat maksutyypit (esim. kertamaksut tai toistuvat maksut). Myös tämän vaiheen voi ohittaa.
  </Step>

  <Step title="Viimeistele sandboxin käyttöönotto">
    Viimeisellä sivulla Stripe näyttää yhteenvedon seuraavista vaiheista: viimeistele käyttöönotto, vaihda live-tilaan ja aloita maksujen vastaanottaminen. Viimeistele napsauttamalla **Go to sandbox**.
  </Step>

  <Step title="Palaa Macalyyn">
    Palaa Macalyyn. Maksut-välilehdellä pitäisi nyt näkyä oranssilla **Maksut ovat testitilassa**, mikä vahvistaa lunastuksen onnistuneen.

    <Info>
      Tilan päivittyminen voi kestää hetken. Jos lunastuspainike näkyy edelleen, päivitä sivu.
    </Info>
  </Step>
</Steps>

## Vaihtaminen live-tilaan

Kun olet valmis vastaanottamaan oikeita maksuja, sinun täytyy aktivoida Stripe-tilisi ja yhdistää live-API-avaimesi Macalyyn.

<Warning>
  Vastaat itse kaikista projektisi kautta vastaanottamiesi maksujen lakisääteisistä ja verovelvoitteista. Jos et ole varma velvoitteistasi, kysy neuvoa veroneuvojalta.
</Warning>

### Aktivoi Stripe-tilisi

Ennen kuin pääset käsiksi live-API-avaimiin, Stripe vaatii yrityksesi vahvistamisen. Tämä on tavallinen käyttöönottoprosessi, joka tapahtuu kokonaan Stripen puolella.

<Steps>
  <Step title="Avaa Stripe Dashboard">
    Siirry osoitteeseen [dashboard.stripe.com](https://dashboard.stripe.com) ja kirjaudu sisään tilille, jolla lunastit sandboxin.
  </Step>

  <Step title="Käy läpi käyttöönotto-opas">
    Stripe pyytää sinua viimeistelemään tilin käyttöönoton. Siihen kuuluu yleensä:

    * Yrityksen tiedot (virallinen nimi, osoite, yritystyyppi)
    * Henkilöllisyyden vahvistus
    * Pankkitili tai muut tiedot varojen vastaanottamista varten

    Seuraa Stripen opasta, kunnes kaikki vaiheet on merkitty valmiiksi.
  </Step>

  <Step title="Odota vahvistusta">
    Stripe tarkistaa tietosi ja aktivoi tilisi. Yleensä se tapahtuu heti, mutta maasta ja yritystyypistä riippuen se voi kestää useita päiviä.

    Vahvistuksen jälkeen tilisi on live-tilassa ja live-API-avaimet tulevat näkyviin Dashboardissa.
  </Step>
</Steps>

<Info>
  Voit jatkaa projektisi rakentamista ja testaamista testitilassa, kun odotat Stripen vahvistavan tilisi.
</Info>

### Syötä live-API-avaimesi

Kun Stripe-tilisi on vahvistettu, kopioi live-avaimesi Macalyyn.

<Steps>
  <Step title="Kopioi avaimesi Stripe Dashboardista">
    Stripe Dashboardissa API-avaimesi näkyvät etusivun oikeassa reunassa olevalla **API keys** -kortilla. Löydät ne myös kohdasta **Developers → API keys** sivupalkin alaosasta.

    Näet kaksi avainta:

    * **Publishable key** alkaa merkeillä `pk_live_`.
    * **Secret key** alkaa merkeillä `sk_live_`.

    Kopioi molemmat avaimet.

    <Warning>
      Secret key -avaimesi antaa täyden pääsyn Stripe-tiliisi. Älä koskaan jaa sitä tai liitä sitä keskusteluun.
    </Warning>
  </Step>

  <Step title="Lisää avaimesi Macalyssa">
    Napsauta **Maksut**-välilehdellä **Lisää Stripe-yhteys**. Liitä kumpikin avain omaan kenttäänsä ja napsauta **Tallenna API-avaimet**. Varmista, että käytät live-avaimia (jotka alkavat merkeillä `pk_live_` ja `sk_live_`), et testiavaimia (`pk_test_` ja `sk_test_`).
  </Step>

  <Step title="Vaihda live-tilaan">
    Napsauta **Vaihda live-tilaan**. Macaly määrittää projektisi käyttämään live-Stripe-tiliäsi. Tilaksi päivittyy vihreällä **Maksut ovat live-tilassa**.
  </Step>

  <Step title="Julkaise projektisi">
    Julkaise projektisi, jotta muutokset otetaan käyttöön. Live-maksut käsitellään vain julkaistulla sivustolla, ei esikatselussa.
  </Step>
</Steps>

## Integraation hallinta

Kaikki maksuasetukset ovat **Maksut**-välilehdellä:

* **Avaa Stripe** avaa Stripe Dashboardin, jossa voit tarkastella tapahtumia, myöntää hyvityksiä ja seurata maksuja tilillesi.
* **Vaihda live-tilaan / Vaihda testitilaan** vaihtaa ympäristöä milloin tahansa vaikuttamatta projektisi koodiin.
* **Hallitse Stripe-yhteyttä** antaa päivittää live-API-avaimesi alkuasennuksen jälkeen.
* **Testimaksut** näyttää testikortin tiedot muistin tueksi testitilassa.

## Vianmääritys

<AccordionGroup>
  <Accordion title="Mikä sandbox on ja miten se eroaa Stripe-tilistäni?">
    Sandbox on väliaikainen testiympäristö, jonka Macaly luo sinulle. Siinä on omat testi-API-avaimensa, ja sen avulla voit simuloida maksuja koskematta oikeaan rahaan. Se **ei** ole Stripe-tilisi. Kun lunastat sandboxin, yhdistät sen varsinaiseen Stripe-tiliisi. Kunnes lunastat sen, sandbox on anonyymi ja vanhenee 60 päivän kuluttua.
  </Accordion>

  <Accordion title="Testimaksut eivät mene läpi">
    Varmista, että käytät testikorttinumeroa **4242 4242 4242 4242**, mitä tahansa tulevaa voimassaolopäivää, mitä tahansa 3-numeroista CVC-koodia ja mitä tahansa postinumeroa. Jos ongelma jatkuu, tarkista keskustelusta virheen tiedot tai pyydä agenttia selvittämään maksuprosessin vika.
  </Accordion>

  <Accordion title="Mitä eroa on testitilalla ja live-tilalla?">
    **Testitila** käyttää sandbox-ympäristöä ja testiavaimia. Kaikki maksut ovat simuloituja, eikä oikeaa rahaa liiku. **Live-tila** käyttää vahvistettua Stripe-tiliäsi ja live-avaimia. Oikeaa rahaa veloitetaan ja se talletetaan pankkitilillesi. Voit vaihtaa tilojen välillä milloin tahansa Maksut-välilehdellä. Tilan vaihtaminen ei vaikuta projektisi koodiin, vain siihen, mitkä Stripe-avaimet ovat käytössä.
  </Accordion>

  <Accordion title="En löydä live-API-avaimia Stripe Dashboardista">
    Sandboxin lunastaminen ja Stripe-tilisi vahvistaminen ovat kaksi erillistä vaihetta. Lunastus yhdistää sandboxin tiliisi, mutta sinun täytyy silti käydä läpi Stripen yritysvahvistus (henkilöllisyys, yrityksen tiedot, pankkitili), ennen kuin live-avaimet luodaan. Avaa Stripe Dashboard ja viimeistele vahvistus käyttöönotto-oppaan mukaan. Jos näet vain testiavaimia (jotka alkavat merkeillä `pk_test_` ja `sk_test_`), tiliäsi ei ole vielä vahvistettu kokonaan.
  </Accordion>

  <Accordion title="Macaly näyttää edelleen testitilan, vaikka vahvistin Stripe-tilini">
    Stripe-tilin vahvistaminen ei vaihda Macalya automaattisesti live-tilaan. Sinun täytyy syöttää live-API-avaimesi Maksut-välilehdellä itse ja napsauttaa sitten **Vaihda live-tilaan**. Macaly pysyy testitilassa, kunnes vaihdat tilan itse.
  </Accordion>

  <Accordion title="Live-maksut eivät mene läpi">
    Tarkista kolme asiaa tässä järjestyksessä:

    1. **Oletko julkaissut projektisi?** Live-maksut käsitellään vain julkaistulla sivustolla, ei esikatselussa.
    2. **Ovatko avaimesi oikein?** Varmista, että syötit **Julkaistava avain** -kenttään avaimen, joka alkaa merkeillä `pk_live_`, ja **Salainen avain** -kenttään avaimen, joka alkaa merkeillä `sk_live_`. Jos liitit vahingossa testiavaimet, napsauta **Hallitse Stripe-yhteyttä** ja päivitä ne.
    3. **Onko Stripe-tilisi vahvistettu kokonaan?** Avaa Stripe Dashboard ja tarkista, onko käyttöönotto-oppaassa keskeneräisiä vaiheita. Stripe voi vaatia lisäasiakirjoja ennen live-maksujen käsittelyä.
  </Accordion>

  <Accordion title="Mitä tapahtuu, kun sandboxini vanhenee?">
    Lunastamattomat sandboxit vanhenevat 60 päivän kuluttua. Avaa Maksut-välilehti ja napsauta **Luo uusi sandbox** luodaksesi uuden ympäristön. Nykyinen maksukoodisi säilyy ennallaan. Jos olit jo lunastanut ja vahvistanut Stripe-tilisi, sinun täytyy syöttää live-avaimesi uudelleen uuden sandboxin luomisen jälkeen.
  </Accordion>
</AccordionGroup>

## Hyvä tietää

* **Stripe perii omat maksunsa.** Macaly ei veloita maksuista lisämaksuja. Jokaiseen tapahtumaan sovelletaan Stripen tavallisia käsittelymaksuja (katso [stripe.com/pricing](https://stripe.com/pricing)).
* **Sandboxin vanheneminen.** Lunastamattomat testiympäristöt vanhenevat 60 päivän kuluttua. Jos näin käy, avaa Maksut-välilehti ja napsauta **Luo uusi sandbox** luodaksesi uuden.
* **Webhookit hallitaan automaattisesti.** Macaly määrittää ja ylläpitää kaikki webhook-päätepisteet. Stripe Dashboardissa ei tarvita manuaalista määritystä.
* **Testi- ja live-ympäristöt on eristetty toisistaan.** Testitapahtumat eivät näy live-Stripe-tililläsi, eikä oikeita veloituksia tehdä.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.