Integrationer og API
Kustom: ordreflow, fejl og grænser
Hvad BunStack og Kustom gør fra kasse til refusion, hvor fejl vises, årsagerne til Needs attention og kaldegrænserne.
Hvor: ordren, Abandoned checkouts og Stack › Kustom.
Hvad der sker hvornår
| Tidspunkt | Hvad BunStack gør |
|---|---|
| Kunden åbner kassen | Opretter en session hos Kustom med linjer, moms, rabat og fragt. Indlejrer widgeten. |
| Kunden klikker køb | Kustom beder BunStack validere købet. BunStack kontrollerer sessionen, at butikken er live, lageret, landet, beløbet og valutaen. Et nej sender kunden tilbage til kassen med årsagen. |
| Kunden lander på bekræftelsessiden | Opretter ordren som betalt og sender ordrebekræftelsen. |
| Cirka 2 minutter senere | Modtager Kustoms push. Findes ordren allerede, sker der intet. Ellers opretter pushen ordren. |
| Hvert 15. minut | Spørger Kustom om sessioner, der hverken har fået bekræftelse eller push. Gennemførte bliver ordrer. Sessioner, Kustom ikke kunne spørges om, markeres. |
| Svindelkontrol | Lægger Kustoms besked på ordren, når den kommer på push-adressen. |
| Levering | Trækker de sendte linjer, og fragten ved første træk. Det sker efter bookingen og før ordren markeres som sendt. |
| Refusion, annullering | Sender dem til Kustom. Intet ændres i BunStack, før Kustom har svaret OK. |
| Hver dag 06:15 UTC | Sender notifikationen Authorisation expiring for hver ordre, der ikke er helt trukket, og hvis reservation udløber inden for 3 dage. |
- Kustom prøver pushen igen efter 5, 15, 30 og 60 minutter. Derefter prøver Kustom hver 4. time i 48 timer.
- Lageret kontrolleres kun for varianter, der stopper ved nul.
- Et træk, der mislykkes, lader ordren stå usendt. Den bookede forsendelse bliver liggende til næste forsøg.
- Kustoms ordre-ID står på ordren under Customer › Kustom order ID, med Copy. Det er samme ID, som Kustoms portal viser.
- Kustom får BunStacks ordrenummer som merchant reference 1. Med ProSmart tilsluttet kan Kustoms ordre-ID følge med til ProSmart. Se Hvad ordren får med.
Fejl og hvor de vises
| Hvor | Hvad du ser |
|---|---|
| Stack › Kustom | ERROR med årsagen fra den seneste kontrol. Hvert miljø viser sin egen status. |
| Ordren | Capture, refusion og annullering afvises, når ordrens miljø ikke er tilsluttet. Beskeden navngiver miljøet. |
| Kassen | Kunden ser en kort besked: kassen er ikke aktiveret, valutaen virker ikke for landet, en vare er udsolgt, eller landet understøttes ikke. |
| Abandoned checkouts | promotion failed med Retry promotion: Kustom rapporterede betalt, men ordren blev ikke oprettet. outcome unknown: Kustom kunne ikke spørges. Kontrollér sessionen i Kustoms portal. |
| Notifikationer og mail | En ordre, der ikke kunne oprettes, eller en uløst session giver en notifikation og en mail til kontaktadressen. |
En ordre kan få Needs attention fra Kustom. Årsagen står på ordren.
| Årsag | Betyder | Gør sådan |
|---|---|---|
| oversold | Kunden betalte for flere enheder, end der var. Ordren beholdes. | Vælg at sende, restnotere eller refundere. |
| Beløbs- eller valutaafvigelse | Kustoms beløb eller valuta afviger fra sessionen. Ordren oprettes alligevel. | Sammenlign ordren med Kustoms portal, før du sender. |
| Landeafvigelse | Adressen fra Kustom ligger i et andet land end det, momsen blev beregnet for. | Kontrollér momsen, før du sender. |
| fraud pending | Kustoms svindelkontrol kører. Trækket er spærret. | Vent, til Kustom godkender ordren. |
| fraud rejected | Kustom afviste ordren i svindelkontrollen. | Send ikke. Annullér ordren. |
| Kustom cancelled | Kustom annullerede ordren. Reservationen gælder ikke længere. | Send ikke. Annullér ordren. |
Kaldegrænser
- Ny kassesession: 10 pr. minut pr. butik og IP-adresse.
- Bekræftelsessiden: 10 pr. minut pr. Kustom-ordre.
- Validering og push beskyttes af et token, ikke af en grænse. Forkert token giver svaret 404.