BunStackDocs

Integrationer og API

Kustom

Tilslut Kustom-kassen: oplysninger for Test og Live, capture, markeder, push-URL, testkøb, butikkens kasse og afbrydelse.

Senest opdateret · 8 min læsning

Kustom (tidligere Klarna Checkout) er kassen i BunStack.

Hvor: Stack › Kustom og Storefronts › [butik] › Checkout.

Kunden betaler i Kustoms widget inde på BunStacks kasseside. BunStack opretter ordren, trækker pengene og sender refusioner og annulleringer til Kustom. Hvordan kassen ser ud for kunden, står på Kassen. Hvordan du trækker og refunderer, står på Træk pengene, refundér og annullér.

Tilslut Kustom

  1. Hent API-brugernavn og adgangskode i Kustoms merchant portal. Test og Live har forskellige oplysninger.
  2. Åbn Stack › Kustom.
  3. Vælg Test · playground eller Live · production under Environment.
  4. Udfyld Username og Password.
  5. Tryk Connect Kustom.
  6. Åbn Storefronts › [butik] › Checkout og vælg Kustom (hosted) under Provider.

Butikken tager nu betaling gennem Kustom, i det miljø der bruges.

FeltHvad du indtaster
EnvironmentTest · playground (api.playground.kustom.co) eller Live · production (api.kustom.co)
UsernameAPI-brugernavnet fra Kustoms merchant portal
PasswordAPI-adgangskoden fra samme portal
  • Den første tilslutning gør miljøet til det, der bruges. Det gælder også den første tilslutning efter en afbrydelse.
  • En tilslutning på Live gør Live til det, der bruges, med det samme. Tilslut på Test først, hvis du vil gemme Live-oplysningerne uden at bruge dem.
  • Det miljø, der bruges, gælder alle butikker i workspacet.
  • Kustom (hosted) kan ikke vælges, før Kustom er tilsluttet.
  • BunStack gemmer oplysningerne krypteret. Admin viser dem aldrig igen.

Kontrollen af oplysningerne

Connect Kustom gemmer oplysningerne og prøver dem mod Kustom. BunStack kører samme kontrol, hver gang du gemmer. Re-verify prøver det miljø, der bruges, igen, uden at du indtaster noget.

Kustom svarerStatusGør sådan
Godkender oplysningerneCONNECTEDIntet.
HTTP 401 eller 403ERROR, med årsagenKontrollér brugernavn og adgangskode. De kan høre til det andet miljø.
5xx, intet svar inden for 8 sekunder eller værten kan ikke nåsUændretIntegrationssiden viser, at Kustom ikke kunne nås. Kør kontrollen igen senere.

Et miljø med ERROR beholder sine indstillinger.

Test og Live

Test og Live har hvert sit brugernavn, sin adgangskode og sin status. Integrationssiden viser begge. in use står ved det miljø, nye kasser går til.

KnapHvad der sker
Save Test credentials, Save Live credentialsGemmer og kontrollerer miljøets oplysninger. Det miljø, der bruges, ændres ikke.
Update Test credentials, Update Live credentialsSamme knap, når miljøet allerede har gemte oplysninger.
Check stored Test login, Check stored Live loginKontrollerer de gemte oplysninger igen. Du indtaster intet.
Use Test, Use LiveGør miljøet til det, der bruges, efter at du har bekræftet. Use Live venter på de rækker, der er mærket holds Use Live på Go live-siden, se Use Live.
  • Use Test og Use Live kontrollerer først miljøets gemte oplysninger. Godkender Kustom dem ikke, ændres intet.
  • Dialogen viser, om ordrer fra det miljø, du forlader, stadig kan trækkes, refunderes og annulleres.
  • En butik kan ikke gå live, mens Test bruges. Kontrollen Kustom environment på Go live er rød, til Live bruges.

Ordrens miljø

  • En ordre trækkes, refunderes og annulleres i det miljø, den blev betalt i. Det miljø, der bruges, er ligegyldigt.
  • Eksempel: en live-ordre trækkes i Live, mens Test bruges. En testordre refunderes i playground, mens Live bruges.
  • Er ordrens miljø ikke tilsluttet, afvises handlingen. Beskeden navngiver miljøet: This order was paid in Kustom Live; Live is not connected.
  • En ordre uden gemt miljø bruger kassesessionens miljø. Mangler begge, bruges det miljø, der bruges nu.
  • Bekræftelsessiden og Kustoms push går til det miljø, hvor kassen blev åbnet.

Oplysninger gemt før 2. oktober 2026

Før 2. oktober 2026 gemte BunStack ét sæt oplysninger til begge miljøer. Sættet regnes til det miljø, hvor det sidst blev kontrolleret, og integrationssiden viser hvilket. Godkendte Kustom ikke sættet der, viser integrationssiden Check them on Live eller Check them on Test. Knappen prøver sættet i det andet miljø. Sættet flyttes kun derhen, hvis Kustom godkender det. Use Live laver samme kontrol før skiftet.

Capture, markeder og push-URL

Tre kort vises, når Kustom er tilsluttet.

KortHvad det gør
CaptureVælger, hvornår pengene trækkes: On fulfilment eller Auto.
MarketsViser, hvad Kustom har svaret for hvert land, dine butikker sælger til, i den valuta en kunde derfra betaler i. Kontrollen Currencies & payment på Go live tæller svarene.
Push URLAdressen Kustom kalder, når kunden har betalt. Den har ét token pr. workspace.

Capture

TilstandHvad der sker
On fulfilment (standard)Kustom reserverer beløbet ved købet. BunStack trækker det, når du markerer ordren som sendt. En dellevering trækker kun den del.
AutoKustom trækker hele beløbet, når kunden gennemfører købet.

Advarsel: En reservation gælder i 28 dage. BunStack sender notifikationen Authorisation expiring, når der er tre dage tilbage. Send ordren, før reservationen udløber.

Markets

BunStack spørger Kustom om hvert land, dine butikker sælger til, i den valuta en kunde derfra betaler i, og gemmer svaret. Du tilføjer ikke par selv.

  • Par, som ingen har spurgt om, sendes til Kustom, når du åbner Stack › Kustom, fanen Checkout for en butik eller butikkens Go live-side.
  • Tryk Check with Kustom for at spørge om alle par igen, for eksempel når Kustom har tilføjet et marked i jeres aftale.
  • Hvert spørgsmål åbner en kasse hos Kustom, som aldrig gennemføres. Ingen betaler noget.
  • Kassen gemmer også svar. Afviser Kustom et par, når en kunde skal betale, kommer parret under Kustom said no.
  • Svarene gælder det miljø, Kustom står i. Efter Use Live spørger BunStack om parrene igen.
DelHvad den viser
Kustom said noDe par, Kustom afviste, med butikkerne, hvad Kustom svarede og hvornår. Bed Kustom tilføje markedet, og tryk Check with Kustom.
Not asked yetDe par, ingen har spurgt Kustom om endnu.
Kustom takesDe par, Kustom tager.

Valutaen pr. land følger Auto-pick by visitor country under Pricing rules. Se Kontrollerne før go-live. Landene vælger du kun under Sells to på fanen Checkout.

  • Kassen stopper et par, som Kustom har afvist, og tilbyder kunden en valuta, der virker.
  • Indtil Kustom har fået sit første spørgsmål i miljøet, gælder listen, der blev skrevet ind tidligere. Kortet viser den. En tom liste slipper alle par igennem.
  • Under Stack › Payments viser en rød række de lande, der ikke kan betale, pr. butik.
  • Kortet viser Kustoms kernemarkeder: 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 betalingsmetoder. Resten af EU betaler i EUR med kort, Apple Pay eller Google Pay. Brug listen, når du taler med Kustom.

Push URL

  • Kassesessionerne sender adressen til Kustom automatisk. Du skal kun bruge den, hvis Kustom beder dig registrere en push-URL.
  • Rotate token gør den gamle adresse ugyldig med det samme. Kasser, der blev åbnet før skiftet, afvises, når Kustom validerer købet.

Testkøb

I Test · playground viser widgeten "Test Mode" og knappen Test Data.

  1. Tilslut Kustom med oplysningerne for Test · playground.
  2. Vælg Kustom (hosted) under Provider i butikken.
  3. Åbn butikken og læg en vare i kurven.
  4. Gå til kassen.
  5. Tryk Test Data i widgeten. Den udfylder en testkunde.
  6. Gennemfør købet.

Betalingen bekræftes uden rigtige penge. Ordren oprettes, og mailene sendes som normalt. Ordresiden viser PLAYGROUND, og ordren tælles ikke med i rapporterne. Se Testordrer. Widgetens vilkårstekst viser Kustoms egen testforhandler, til Live-kontoen er tilsluttet.

Bemærk: Kustoms playground kan mangle SEK. Test så i NOK eller DKK.

Butikkens kasse

Under Storefronts › [butik] › Checkout vælger du Kustom (hosted) under Provider. Det kræves for at gå live. Testkassen Native, spærringen for live-butikker og betalingslogoerne står under Kasseindstillinger pr. butik.

Hvilke betalingsmetoder widgeten tilbyder, styres af din Kustom-aftale.

Afbryd

Advarsel: Disconnect afvises, så længe en live-butik bruger Kustom som kasse. Integrationssiden viser butikkerne med link til deres fane Checkout. Skift kasse eller sæt butikkerne på pause først.

Afvises Disconnect, fjernes intet. Ellers gør Disconnect dette:

  • sletter brugernavn og adgangskode for begge miljøer
  • fjerner Kustom-indstillingerne: miljø, capture-tilstand, markeder og push-token
  • stopper ordreflowet i hver butik, der er sat til Kustom

Der findes ingen reservekasse. Tilslutter du igen, indtaster du alt på ny.

Se også