Integrasjoner og API
Kustom
Koble til Kustom-kassen: opplysninger for Test og Live, capture, markeder, push-URL, testkjøp, butikkens kasse og frakobling.
Kustom (tidligere Klarna Checkout) er kassen i BunStack.
Hvor: Stack › Kustom og Storefronts › [butikk] › Checkout.
Kunden betaler i Kustoms widget inne på BunStacks kasseside. BunStack oppretter ordren, trekker pengene og sender refusjoner og kanselleringer til Kustom. Hvordan kassen ser ut for kunden, står på Kassen. Hvordan du trekker og refunderer, står på Trekk pengene, refunder og kanseller.
Koble til Kustom
- Hent API-brukernavn og passord i Kustoms merchant portal. Test og Live har ulike opplysninger.
- Åpne Stack › Kustom.
- Velg Test · playground eller Live · production under Environment.
- Fyll inn Username og Password.
- Trykk Connect Kustom.
- Åpne Storefronts › [butikk] › Checkout og velg Kustom (hosted) under Provider.
Butikken tar nå betalt gjennom Kustom, i miljøet som brukes.
| Felt | Hva du legger inn |
|---|---|
| Environment | Test · playground (api.playground.kustom.co) eller Live · production (api.kustom.co) |
| Username | API-brukernavnet fra Kustoms merchant portal |
| Password | API-passordet fra samme portal |
- Den første tilkoblingen gjør miljøet til det som brukes. Det gjelder også første tilkobling etter en frakobling.
- En tilkobling på Live gjør Live til det som brukes med en gang. Koble til på Test først hvis du vil lagre Live-opplysningene uten å bruke dem.
- Miljøet som brukes, gjelder alle butikker i workspacet.
- Kustom (hosted) kan ikke velges før Kustom er tilkoblet.
- BunStack lagrer opplysningene kryptert. Admin viser dem aldri igjen.
Kontrollen av opplysningene
Connect Kustom lagrer opplysningene og prøver dem mot Kustom. BunStack gjør samme kontroll hver gang du lagrer. Re-verify prøver miljøet som brukes på nytt, uten at du legger inn noe.
| Kustom svarer | Status | Gjør slik |
|---|---|---|
| Godtar opplysningene | CONNECTED | Ingenting. |
| HTTP 401 eller 403 | ERROR, med årsaken | Kontroller brukernavn og passord. De kan høre til det andre miljøet. |
| 5xx, intet svar innen 8 sekunder eller verten nås ikke | Uendret | Integrasjonssiden viser at Kustom ikke kunne nås. Kjør kontrollen igjen senere. |
Et miljø med ERROR beholder innstillingene sine.
Test og Live
Test og Live har hvert sitt brukernavn, passord og sin status. Integrasjonssiden viser begge. in use står ved miljøet nye kasser går til.
| Knapp | Hva som skjer |
|---|---|
| Save Test credentials, Save Live credentials | Lagrer og kontrollerer miljøets opplysninger. Miljøet som brukes, endres ikke. |
| Update Test credentials, Update Live credentials | Samme knapp når miljøet allerede har lagrede opplysninger. |
| Check stored Test login, Check stored Live login | Kontrollerer de lagrede opplysningene igjen. Du legger ikke inn noe. |
| Use Test, Use Live | Gjør miljøet til det som brukes, etter at du har bekreftet. Use Live venter på radene merket holds Use Live på Go live-siden, se Use Live. |
- Use Test og Use Live kontrollerer først miljøets lagrede opplysninger. Godtar Kustom dem ikke, endres ingenting.
- Dialogen viser om ordrer fra miljøet du forlater, fortsatt kan trekkes, refunderes og kanselleres.
- En butikk kan ikke gå live mens Test brukes. Kontrollen Kustom environment på Go live er rød til Live brukes.
Ordrens miljø
- En ordre trekkes, refunderes og kanselleres i miljøet den ble betalt i. Miljøet som brukes, spiller ingen rolle.
- Eksempel: en live-ordre trekkes i Live mens Test brukes. En testordre refunderes i playground mens Live brukes.
- Er ordrens miljø ikke tilkoblet, avvises handlingen. Meldingen navngir miljøet: This order was paid in Kustom Live; Live is not connected.
- En ordre uten lagret miljø bruker kassesesjonens miljø. Mangler begge, brukes miljøet som brukes nå.
- Bekreftelsessiden og Kustoms push går til miljøet der kassen ble åpnet.
Opplysninger lagret før 2. oktober 2026
Før 2. oktober 2026 lagret BunStack ett par opplysninger for begge miljøene. Paret regnes til miljøet der det sist ble kontrollert, og integrasjonssiden viser hvilket. Godtok Kustom ikke paret der, viser integrasjonssiden Check them on Live eller Check them on Test. Knappen prøver paret i det andre miljøet. Paret flyttes dit bare hvis Kustom godtar det. Use Live gjør samme kontroll før byttet.
Capture, markeder og push-URL
Tre kort vises når Kustom er tilkoblet.
| Kort | Hva det gjør |
|---|---|
| Capture | Velger når pengene trekkes: On fulfilment eller Auto. |
| Markets | Viser hva Kustom har svart for hvert land butikkene dine selger til, i valutaen en kunde derfra betaler i. Kontrollen Currencies & payment på Go live teller svarene. |
| Push URL | Adressen Kustom kaller når kunden har betalt. Den har ett token per workspace. |
Capture
| Modus | Hva som skjer |
|---|---|
| On fulfilment (standard) | Kustom reserverer beløpet ved kjøpet. BunStack trekker det når du merker ordren som sendt. En dellevering trekker bare den delen. |
| Auto | Kustom trekker hele beløpet når kunden fullfører kjøpet. |
Advarsel: En reservasjon gjelder i 28 dager. BunStack sender varselet Authorisation expiring når det gjenstår tre dager. Send ordren før reservasjonen går ut.
Markets
BunStack spør Kustom om hvert land butikkene dine selger til, i valutaen en kunde derfra betaler i, og lagrer svaret. Du legger ikke inn par selv.
- Par som ingen har spurt om, sendes til Kustom når du åpner Stack › Kustom, fanen Checkout for en butikk eller butikkens Go live-side.
- Trykk Check with Kustom for å spørre om alle par igjen, for eksempel når Kustom har lagt til et marked i avtalen deres.
- Hvert spørsmål åpner en kasse hos Kustom som aldri fullføres. Ingen betaler noe.
- Kassen lagrer også svar. Avviser Kustom et par når en kunde skal betale, havner paret under Kustom said no.
- Svarene gjelder miljøet Kustom står i. Etter Use Live spør BunStack om parene igjen.
| Del | Hva den viser |
|---|---|
| Kustom said no | Parene Kustom avviste, med butikkene, hva Kustom svarte og når. Be Kustom legge til markedet og trykk Check with Kustom. |
| Not asked yet | Parene ingen har spurt Kustom om ennå. |
| Kustom takes | Parene Kustom tar. |
Valutaen per land følger Auto-pick by visitor country under Pricing rules. Se Kontrollene før go-live. Landene velger du bare under Sells to i fanen Checkout.
- Kassen stopper et par Kustom har avvist, og tilbyr kunden en valuta som virker.
- Til Kustom har fått sitt første spørsmål i miljøet, gjelder listen som ble skrevet inn tidligere. Kortet viser den. En tom liste slipper alle par gjennom.
- Under Stack › Payments viser en rød rad landene som ikke kan betale, per butikk.
- Kortet viser Kustoms kjernemarkeder: AT, BE, CH, CZ, DE, DK, ES, FI, FR, GB, GR, IE, IT, NL, NO, PL, PT og SE. Der betaler kunden i landets valuta med Kustoms egne betalingsmåter. Resten av EU betaler i EUR med kort, Apple Pay eller Google Pay. Bruk listen når du snakker med Kustom.
Push URL
- Kassesesjonene sender adressen til Kustom automatisk. Du trenger den bare hvis Kustom ber deg registrere en push-URL.
- Rotate token gjør den gamle adressen ugyldig med en gang. Kasser åpnet før byttet avvises når Kustom validerer kjøpet.
Testkjøp
I Test · playground viser widgeten "Test Mode" og knappen Test Data.
- Koble til Kustom med opplysningene for Test · playground.
- Velg Kustom (hosted) under Provider i butikken.
- Åpne butikken og legg en vare i handlekurven.
- Gå til kassen.
- Trykk Test Data i widgeten. Den fyller inn en testkunde.
- Fullfør kjøpet.
Betalingen bekreftes uten ekte penger. Ordren opprettes og e-postene sendes som vanlig. Ordresiden viser PLAYGROUND, og ordren telles ikke i rapportene. Se Testordrer. Widgetens vilkårstekst viser Kustoms egen testforhandler til Live-kontoen er koblet til.
Merk: Kustoms playground kan mangle SEK. Test da i NOK eller DKK.
Butikkens kasse
Under Storefronts › [butikk] › Checkout velger du Kustom (hosted) under Provider. Det kreves for å gå live. Testkassen Native, sperren for live-butikker og betalingslogoene står under Kasseinnstillinger per butikk.
Hvilke betalingsmåter widgeten tilbyr, styres av Kustom-avtalen din.
Koble fra
Advarsel: Disconnect avvises så lenge en live-butikk har Kustom som kasse. Integrasjonssiden viser butikkene med lenke til fanen Checkout. Bytt kasse eller sett butikkene på pause først.
Avvises Disconnect, fjernes ingenting. Ellers gjør Disconnect dette:
- sletter brukernavn og passord for begge miljøene
- fjerner Kustom-innstillingene: miljø, capture-modus, markeder og push-token
- stopper ordreflyten i hver butikk som er satt til Kustom
Det finnes ingen reservekasse. Kobler du til igjen, legger du inn alt på nytt.