Integraatiot ja API
Kustom
Kytke Kustom-kassa: tunnukset Testille ja Livelle, veloitus, markkinat, push-URL, testiostot, kaupan kassa ja irtikytkentä.
Kustom (entinen Klarna Checkout) on BunStackin kassa.
Missä: Stack › Kustom ja Storefronts › [kauppa] › Checkout.
Asiakas maksaa Kustomin widgetissä BunStackin kassasivun sisällä. BunStack luo tilauksen, veloittaa rahat ja lähettää hyvitykset ja peruutukset Kustomiin. Miltä kassa näyttää asiakkaalle, kerrotaan sivulla Kassa. Veloitus ja hyvitys kerrotaan sivulla Veloita, hyvitä ja peru.
Kytke Kustom
- Hae API-käyttäjätunnus ja salasana Kustomin merchant portalista. Testillä ja Livellä on eri tunnukset.
- Avaa Stack › Kustom.
- Valitse kohdassa Environment joko Test · playground tai Live · production.
- Täytä Username ja Password.
- Paina Connect Kustom.
- Avaa Storefronts › [kauppa] › Checkout ja valitse kohdassa Provider Kustom (hosted).
Kauppa ottaa nyt maksut Kustomin kautta käytössä olevassa ympäristössä.
| Kenttä | Mitä syötät |
|---|---|
| Environment | Test · playground (api.playground.kustom.co) tai Live · production (api.kustom.co) |
| Username | API-käyttäjätunnus Kustomin merchant portalista |
| Password | API-salasana samasta portaalista |
- Ensimmäinen kytkentä ottaa ympäristönsä käyttöön. Sama koskee ensimmäistä kytkentää irtikytkennän jälkeen.
- Kytkentä Livessä ottaa Liven käyttöön heti. Kytke ensin Testissä, jos haluat tallentaa Liven tunnukset käyttämättä niitä.
- Käytössä oleva ympäristö koskee kaikkia workspacen kauppoja.
- Kustom (hosted) -vaihtoehtoa ei voi valita ennen kuin Kustom on kytketty.
- BunStack tallentaa tunnukset salattuina. Admin ei näytä niitä enää koskaan.
Tunnusten tarkistus
Connect Kustom tallentaa tunnukset ja kokeilee niitä Kustomia vasten. BunStack tekee saman tarkistuksen aina, kun tallennat. Re-verify kokeilee käytössä olevaa ympäristöä uudelleen ilman, että syötät mitään.
| Kustom vastaa | Tila | Toimi näin |
|---|---|---|
| Hyväksyy tunnukset | CONNECTED | Ei mitään. |
| HTTP 401 tai 403 | ERROR ja syy | Tarkista käyttäjätunnus ja salasana. Ne voivat kuulua toiseen ympäristöön. |
| 5xx, ei vastausta 8 sekunnissa tai palvelinta ei tavoiteta | Ei muutosta | Integraation sivu kertoo, ettei Kustomia tavoitettu. Tee tarkistus myöhemmin uudelleen. |
Ympäristö, jonka tila on ERROR, säilyttää asetuksensa.
Test ja Live
Testillä ja Livellä on kummallakin oma käyttäjätunnus, salasana ja tila. Integraation sivu näyttää molemmat. in use on sen ympäristön kohdalla, johon uudet kassat menevät.
| Painike | Mitä tapahtuu |
|---|---|
| Save Test credentials, Save Live credentials | Tallentaa ja tarkistaa ympäristön tunnukset. Käytössä oleva ympäristö ei vaihdu. |
| Update Test credentials, Update Live credentials | Sama painike, kun ympäristöllä on jo tallennetut tunnukset. |
| Check stored Test login, Check stored Live login | Tarkistaa tallennetut tunnukset uudelleen. Et syötä mitään. |
| Use Test, Use Live | Ottaa ympäristön käyttöön vahvistuksen jälkeen. Use Live odottaa Go live -sivun rivejä, joissa on merkintä holds Use Live, katso Use Live. |
- Use Test ja Use Live tarkistavat ensin ympäristön tallennetut tunnukset. Jos Kustom ei hyväksy niitä, mikään ei muutu.
- Vahvistusikkuna kertoo, voiko jätettävän ympäristön tilauksia yhä veloittaa, hyvittää ja perua.
- Kauppa ei voi siirtyä liveen, kun Test on käytössä. Tarkistus Kustom environment sivulla Go live on punainen, kunnes Live on käytössä.
Tilauksen ympäristö
- Tilaus veloitetaan, hyvitetään ja perutaan siinä ympäristössä, jossa se maksettiin. Käytössä olevalla ympäristöllä ei ole merkitystä.
- Esimerkiksi live-tilaus veloitetaan Livessä, kun Test on käytössä. Testitilaus hyvitetään playgroundissa, kun Live on käytössä.
- Jos tilauksen ympäristöä ei ole kytketty, toiminto hylätään. Viesti nimeää ympäristön: This order was paid in Kustom Live; Live is not connected.
- Tilaus, jolla ei ole tallennettua ympäristöä, käyttää kassaistunnon ympäristöä. Jos kumpaakaan ei ole, käytetään nyt käytössä olevaa ympäristöä.
- Vahvistussivu ja Kustomin push menevät siihen ympäristöön, jossa kassa avattiin.
Ennen 2.10.2026 tallennetut tunnukset
Ennen 2.10.2026 BunStack tallensi yhden tunnusparin molemmille ympäristöille. Pari lasketaan siihen ympäristöön, jossa se viimeksi tarkistettiin, ja integraation sivu kertoo, mihin. Jos Kustom ei hyväksynyt paria siellä, integraation sivu näyttää Check them on Live tai Check them on Test. Painike kokeilee paria toisessa ympäristössä. Pari siirretään sinne vain, jos Kustom hyväksyy sen. Use Live tekee saman tarkistuksen ennen vaihtoa.
Veloitus, markkinat ja push-URL
Kolme korttia näkyy, kun Kustom on kytketty.
| Kortti | Mitä se tekee |
|---|---|
| Capture | Valitsee, milloin rahat veloitetaan: On fulfilment tai Auto. |
| Markets | Näyttää, mitä Kustom on vastannut jokaisesta maasta, johon kauppasi myyvät, siinä valuutassa, jolla asiakas sieltä maksaa. Go live -tarkistus Currencies & payment laskee vastaukset. |
| Push URL | Osoite, jota Kustom kutsuu, kun asiakas on maksanut. Siinä on yksi token workspacea kohti. |
Capture
| Tila | Mitä tapahtuu |
|---|---|
| On fulfilment (oletus) | Kustom varaa summan oston yhteydessä. BunStack veloittaa sen, kun merkitset tilauksen lähetetyksi. Osatoimitus veloittaa vain sen osan. |
| Auto | Kustom veloittaa koko summan, kun asiakas viimeistelee oston. |
Varoitus: Varaus on voimassa 28 päivää. BunStack lähettää ilmoituksen Authorisation expiring, kun jäljellä on kolme päivää. Lähetä tilaus ennen kuin varaus vanhenee.
Markets
BunStack kysyy Kustomilta jokaisesta maasta, johon kauppasi myyvät, siinä valuutassa, jolla asiakas sieltä maksaa, ja tallentaa vastauksen. Et lisää pareja itse.
- Parit, joista kukaan ei ole kysynyt, lähetetään Kustomille, kun avaat kohdan Stack › Kustom, kaupan välilehden Checkout tai kaupan Go live -sivun.
- Paina Check with Kustom, kun haluat kysyä kaikista pareista uudelleen, esimerkiksi kun Kustom on lisännyt markkinan sopimukseenne.
- Jokainen kysymys avaa Kustomissa kassan, jota ei koskaan viedä loppuun. Kukaan ei maksa mitään.
- Myös kassa tallentaa vastauksia. Jos Kustom hylkää parin, kun asiakas on maksamassa, pari näkyy kohdassa Kustom said no.
- Vastaukset koskevat ympäristöä, jossa Kustom on. Kun painat Use Live, BunStack kysyy pareista uudelleen.
| Osa | Mitä se näyttää |
|---|---|
| Kustom said no | Parit, jotka Kustom hylkäsi, kaupat, Kustomin vastaus ja aika. Pyydä Kustomia lisäämään markkina ja paina Check with Kustom. |
| Not asked yet | Parit, joista kukaan ei ole vielä kysynyt Kustomilta. |
| Kustom takes | Parit, jotka Kustom hyväksyy. |
Maan valuutta seuraa asetusta Auto-pick by visitor country kohdassa Pricing rules. Katso Tarkistukset ennen go-liveä. Maat valitaan vain kohdassa Sells to välilehdellä Checkout.
- Kassa pysäyttää parin, jonka Kustom on hylännyt, ja tarjoaa asiakkaalle valuuttaa, joka toimii.
- Ennen kuin Kustom on saanut ensimmäisen kysymyksen ympäristössä, aiemmin kirjoitettu lista on voimassa. Kortti näyttää sen. Tyhjä lista päästää kaikki parit läpi.
- Kohdassa Stack › Payments punainen rivi näyttää maat, joista ei voi maksaa, kaupoittain.
- Kortti luettelee Kustomin ydinmarkkinat: AT, BE, CH, CZ, DE, DK, ES, FI, FR, GB, GR, IE, IT, NL, NO, PL, PT ja SE. Niissä asiakas maksaa maan valuutalla Kustomin omilla maksutavoilla. Muu EU maksaa euroissa kortilla, Apple Paylla tai Google Paylla. Käytä listaa, kun puhut Kustomin kanssa.
Push URL
- Kassaistunnot lähettävät osoitteen Kustomille automaattisesti. Tarvitset sitä vain, jos Kustom pyytää rekisteröimään push-URL:n.
- Rotate token mitätöi vanhan osoitteen heti. Ennen vaihtoa avatut kassat hylätään, kun Kustom validoi oston.
Testiostot
Tilassa Test · playground widget näyttää tekstin "Test Mode" ja painikkeen Test Data.
- Kytke Kustom tilan Test · playground tunnuksilla.
- Valitse kaupassa Provider-kohdasta Kustom (hosted).
- Avaa kauppa ja lisää tuote ostoskoriin.
- Siirry kassalle.
- Paina widgetissä Test Data. Se täyttää testiasiakkaan.
- Viimeistele osto.
Maksu vahvistetaan ilman oikeaa rahaa. Tilaus luodaan ja sähköpostit lähtevät tavalliseen tapaan. Tilaussivu näyttää PLAYGROUND, eikä tilausta lasketa raportteihin. Katso Testitilaukset. Widgetin ehtoteksti näyttää Kustomin oman testikauppiaan, kunnes Live-tili on kytketty.
Huom: Kustomin playgroundista voi puuttua SEK. Testaa silloin NOK:lla tai DKK:lla.
Kaupan kassa
Kohdassa Storefronts › [kauppa] › Checkout valitset Provider-kohdasta Kustom (hosted). Se vaaditaan liveen siirtymiseen. Native-testikassa, live-kauppojen esto ja maksutapojen logot kerrotaan sivulla Kassan asetukset kaupoittain.
Widgetin tarjoamat maksutavat riippuvat Kustom-sopimuksestasi.
Kytke irti
Varoitus: Disconnect hylätään niin kauan kuin jokin live-kauppa käyttää Kustomia kassana. Integraation sivu listaa kaupat linkkeineen niiden Checkout-välilehdelle. Vaihda kassa tai keskeytä kaupat ensin.
Jos Disconnect hylätään, mitään ei poisteta. Muuten Disconnect tekee näin:
- poistaa molempien ympäristöjen käyttäjätunnuksen ja salasanan
- poistaa Kustom-asetukset: ympäristön, veloitustilan, markkinat ja push-tokenin
- pysäyttää tilausvirran jokaisessa kaupassa, joka on asetettu Kustomiin
Varakassaa ei ole. Kun kytket uudelleen, syötät kaiken alusta.