Skip to main content
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.
Käytettävissä Pro- ja Toimisto-paketeissa

​
Maksujen lisääminen projektiisi

Kuvaile maksutarpeesi agentille keskustelussa. Esimerkiksi:
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: Avaa projektisi, tee testiosto ja tarkista, miten kassa toimii.
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.

​
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.
1

Avaa Maksut-välilehti

Avaa projektisi Maksut-välilehti. Otsikon “Aktivoi suojattu testialueesi” alla näkyy Lunasta Stripe-sandboxisi -painike.
2

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

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

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

Palaa Macalyyn

Palaa Macalyyn. Maksut-välilehdellä pitäisi nyt näkyä oranssilla Maksut ovat testitilassa, mikä vahvistaa lunastuksen onnistuneen.
Tilan päivittyminen voi kestää hetken. Jos lunastuspainike näkyy edelleen, päivitä sivu.

​
Vaihtaminen live-tilaan

Kun olet valmis vastaanottamaan oikeita maksuja, sinun täytyy aktivoida Stripe-tilisi ja yhdistää live-API-avaimesi Macalyyn.
Vastaat itse kaikista projektisi kautta vastaanottamiesi maksujen lakisääteisistä ja verovelvoitteista. Jos et ole varma velvoitteistasi, kysy neuvoa veroneuvojalta.

​
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.
1

Avaa Stripe Dashboard

Siirry osoitteeseen dashboard.stripe.com ja kirjaudu sisään tilille, jolla lunastit sandboxin.
2

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

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.
Voit jatkaa projektisi rakentamista ja testaamista testitilassa, kun odotat Stripen vahvistavan tilisi.

​
Syötä live-API-avaimesi

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

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.
Secret key -avaimesi antaa täyden pääsyn Stripe-tiliisi. Älä koskaan jaa sitä tai liitä sitä keskusteluun.
2

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_).
3

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

Julkaise projektisi

Julkaise projektisi, jotta muutokset otetaan käyttöön. Live-maksut käsitellään vain julkaistulla sivustolla, ei esikatselussa.

​
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

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

​
Hyvä tietää

  • Stripe perii omat maksunsa. Macaly ei veloita maksuista lisämaksuja. Jokaiseen tapahtumaan sovelletaan Stripen tavallisia käsittelymaksuja (katso 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ä.