Integrationer & API
Kustom
Koppla Kustom-kassan: uppgifter för Test och Live, capture, marknader, push-URL, testköp, kassan på butiken och bortkoppling.
Kustom (tidigare Klarna Checkout) är kassan i BunStack.
Var: Stack › Kustom och Storefronts › [butik] › Checkout.
Kunden betalar i Kustoms widget inuti BunStacks kassasida. BunStack skapar ordern, drar pengarna och skickar återbetalningar och avbrytanden till Kustom. Kassan visar hur kassan ser ut för kunden. Dra pengarna, återbetala och avbryta visar hur du drar och återbetalar.
Koppla Kustom
- Hämta API-användarnamn och lösenord i Kustoms merchant portal. Test och Live har olika uppgifter.
- Öppna Stack › Kustom.
- Välj Test · playground eller Live · production under Environment.
- Fyll i Username och Password.
- Tryck Connect Kustom.
- Öppna Storefronts › [butik] › Checkout och välj Kustom (hosted) under Provider.
Butiken tar nu betalt genom Kustom, i den miljö som används.
| Fält | Vad du anger |
|---|---|
| Environment | Test · playground (api.playground.kustom.co) eller Live · production (api.kustom.co) |
| Username | API-användarnamnet från Kustoms merchant portal |
| Password | API-lösenordet från samma portal |
- Den första kopplingen gör miljön till den som används. Det gäller också första kopplingen efter en bortkoppling.
- En koppling på Live gör Live till den som används direkt. Koppla på Test först om du vill spara Live-uppgifterna utan att använda dem.
- Miljön som används gäller alla butiker i workspacet.
- Kustom (hosted) går inte att välja förrän Kustom är anslutet.
- BunStack lagrar uppgifterna krypterat. Admin visar dem aldrig igen.
Kontrollen av uppgifterna
Connect Kustom sparar uppgifterna och provar dem mot Kustom. BunStack gör samma kontroll varje gång du sparar. Re-verify provar miljön som används igen, utan att du anger något.
| Kustom svarar | Status | Gör så här |
|---|---|---|
| Godtar uppgifterna | CONNECTED | Inget. |
| HTTP 401 eller 403 | ERROR, med orsaken | Kontrollera användarnamn och lösenord. De kan höra till den andra miljön. |
| 5xx, inget svar inom 8 sekunder eller värden nås inte | Oförändrad | Integrationssidan visar Kustom could not be reached — nothing changed. Try again. Kör kontrollen igen senare. |
En miljö med ERROR behåller sina inställningar.
Test och Live
Test och Live har var sitt användarnamn, lösenord och status. Integrationssidan visar båda. in use står vid miljön som nya kassor går till.
| Knapp | Vad som händer |
|---|---|
| Save Test credentials, Save Live credentials | Sparar och kontrollerar miljöns uppgifter. Miljön som används ändras inte. |
| Update Test credentials, Update Live credentials | Samma knapp när miljön redan har uppgifter sparade. |
| Check stored Test login, Check stored Live login | Kontrollerar de sparade uppgifterna igen. Du anger inget. |
| Use Test, Use Live | Frågar till exempel Use Kustom Live? och gör sedan miljön till den som används. Use Live väntar på raderna märkta holds Use Live på Go live-sidan, se Use Live. |
- Use Test och Use Live kontrollerar först miljöns sparade uppgifter. Godtar Kustom dem inte ändras inget.
- Dialogen visar om ordrar från miljön du lämnar fortfarande kan dras, återbetalas och avbrytas, till exempel Orders paid in Test are still captured, refunded and cancelled in Test.
- En butik kan inte gå live medan Test används. Kontrollen Kustom environment på Go live är röd tills Live används.
Orderns miljö
- En order dras, återbetalas och avbryts i miljön där den betalades. Miljön som används spelar ingen roll.
- Exempel: en live-order dras i Live medan Test används. En testorder återbetalas i playground medan Live används.
- Är orderns miljö inte ansluten nekar BunStack åtgärden. Meddelandet namnger miljön: This order was paid in Kustom Live; Live is not connected.
- En order utan sparad miljö använder kassasessionens miljö. Saknas båda gäller miljön som är in use.
- Bekräftelsesidan och Kustoms push går till miljön där kassan öppnades.
Uppgifter sparade före 2 oktober 2026
Före 2 oktober 2026 sparade BunStack ett par uppgifter för båda miljöerna. Paret räknas till miljön där det senast kontrollerades. Integrationssidan visar till exempel They count as Test's because Test is where they were last checked. Godtog Kustom inte paret i den miljön visar integrationssidan Check them on Live eller Check them on Test. Knappen provar paret i den andra miljön. Paret flyttas dit bara om Kustom godtar det. Use Live gör samma kontroll före bytet.
Capture, marknader och push-URL
Tre kort visas när Kustom är kopplat.
| Kort | Vad det gör |
|---|---|
| Capture | Väljer när pengarna dras: On fulfilment eller Auto. |
| Markets | Visar vad Kustom har svarat för varje land butikerna säljer till, i den valuta en kund därifrån betalar i. Kontrollen Currencies & payment på Go live räknar svaren. |
| Push URL | Adressen Kustom anropar när kunden har betalat. Den innehåller en token per workspace. |
Capture
| Läge | Vad händer |
|---|---|
| On fulfilment (standard) | Kustom reserverar beloppet vid köpet. BunStack drar det när du markerar ordern som skickad. En delleverans drar bara den delen. |
| Auto | Kustom drar hela beloppet när kunden slutför köpet. |
Varning: En reservation gäller i 28 dagar. BunStack skickar notisen Authorisation expiring när det återstår tre dagar. Skicka ordern innan reservationen går ut.
Markets
BunStack frågar Kustom om varje land dina butiker säljer till, i den valuta en kund därifrån betalar i, och sparar svaret. Du lägger inte in par själv.
- Par som ingen har frågat om skickas till Kustom när du öppnar Stack › Kustom, fliken Checkout för en butik eller butikens Go live-sida.
- Tryck Check with Kustom för att fråga om alla par igen, till exempel när Kustom har lagt till en marknad i ert avtal.
- Varje fråga öppnar en kassa hos Kustom som aldrig slutförs. Ingen betalar något.
- Kassan sparar också svar. Nekar Kustom ett par när en kund ska betala, hamnar paret under Kustom said no.
- Svaren gäller den miljö Kustom står i. Efter Use Live frågar BunStack om paren igen.
| Del | Vad den visar |
|---|---|
| Kustom said no | Paren Kustom nekade, med butikerna, vad Kustom svarade och när. Be Kustom lägga till marknaden och tryck Check with Kustom. |
| Not asked yet | Paren ingen har frågat Kustom om än. |
| Kustom takes | Paren Kustom tar. |
Valutan per land följer Auto-pick by visitor country under Pricing rules. Se Kontrollerna före go-live. Länderna väljer du bara under Sells to i fliken Checkout.
- Kassan stoppar ett par som Kustom har nekat och erbjuder kunden en valuta som fungerar.
- Innan Kustom har fått sin första fråga i miljön gäller listan som skrevs in tidigare. Kortet visar den. En tom lista släpper igenom alla par.
- Under Stack › Payments visar en röd rad länderna som inte kan betala, per butik.
- Kortet listar Kustoms kärnmarknader: AT, BE, CH, CZ, DE, DK, ES, FI, FR, GB, GR, IE, IT, NL, NO, PL, PT och SE. Där betalar kunden i landets valuta med Kustoms egna betalsätt. Resten av EU betalar i EUR med kort, Apple Pay eller Google Pay. Använd listan när du pratar med Kustom.
Push URL
- Kassasessionerna skickar adressen till Kustom automatiskt. Du behöver den bara om Kustom ber dig registrera en push-URL.
- Rotate token gör den gamla adressen ogiltig direkt. Kassor som öppnades före bytet nekas när Kustom validerar köpet.
Testköp
I Test · playground visar widgeten "Test Mode" och knappen Test Data.
- Koppla Kustom med uppgifterna för Test · playground.
- Välj Kustom (hosted) under Provider i butiken.
- Öppna butiken och lägg en vara i varukorgen.
- Gå till kassan.
- Tryck Test Data i widgeten. Den fyller i en testkund.
- Slutför köpet.
Betalningen bekräftas utan riktiga pengar. Ordern skapas och mejlen går ut som vanligt. Ordersidan visar PLAYGROUND, och ordern räknas inte i rapporterna. Se Testordrar. Widgetens villkorstext visar Kustoms egen testhandlare tills Live-kontot är kopplat.
Obs: Kustoms playground kan sakna SEK. Testa då i NOK eller DKK.
Kassan på butiken
Under Storefronts › [butik] › Checkout väljer du Kustom (hosted) under Provider. Det krävs för att gå live. Testkassan Native, spärren för live-butiker och betalsättsloggorna beskrivs under Kassans inställningar per butik.
Ditt Kustom-avtal styr vilka betalsätt widgeten erbjuder.
Koppla bort
Varning: Disconnect nekas så länge en live-butik har Kustom som kassa. Integrationssidan listar butikerna med länk till deras flik Checkout. Byt kassa eller pausa butikerna först.
Nekar BunStack tas inget bort. Annars gör Disconnect detta:
- raderar användarnamn och lösenord för båda miljöerna
- tar bort Kustom-inställningarna: miljö, capture-läge, marknader och push-token
- stoppar orderflödet i varje butik som är satt till Kustom
Det finns ingen reservkassa. Kopplar du igen anger du allt på nytt.