Integrationer & API
Kustom: orderflöde, fel och gränser
Vad BunStack och Kustom gör från kassa till återbetalning, var fel syns, orsakerna till Needs attention och anropsgränserna.
Var: ordern, Abandoned checkouts och Stack › Kustom.
Vad som händer när
| Tillfälle | Vad BunStack gör |
|---|---|
| Kunden öppnar kassan | Skapar en session hos Kustom med rader, moms, rabatt och frakt. Bäddar in widgeten. |
| Kunden klickar köp | Kustom ber BunStack validera köpet. BunStack kontrollerar sessionen, att butiken är live, lagret, landet, beloppet och valutan. Nekar BunStack köpet kommer kunden tillbaka till kassan med orsaken. |
| Kunden kommer till bekräftelsesidan | Skapar ordern som betald och skickar orderbekräftelsen. |
| Cirka 2 minuter senare | Tar emot Kustoms push. Finns ordern redan händer inget. Annars skapar pushen ordern. |
| Var 15:e minut | Hämtar sessioner som varken fått bekräftelse eller push från Kustom. Slutförda sessioner blir ordrar. Flaggar sessioner som BunStack inte kunde fråga Kustom om. |
| Bedrägerikontroll | Lägger Kustoms besked på ordern när det kommer på push-adressen. |
| Leverans | Drar de skickade raderna, och frakten vid första dragningen. Det sker efter bokningen och innan ordern markeras som skickad. |
| Återbetalning, avbryt | Skickar dem till Kustom. Inget ändras i BunStack förrän Kustom svarat OK. |
| Varje dag 06:15 UTC | Skickar notisen Authorisation expiring för varje order som inte är helt dragen och vars reservation går ut inom 3 dagar. |
- Kustom försöker igen med pushen efter 5, 15, 30 och 60 minuter. Sedan försöker Kustom var 4:e timme i 48 timmar.
- BunStack kontrollerar lagret bara för varianter som spärras vid noll.
- En dragning som misslyckas lämnar ordern oskickad. Den bokade försändelsen ligger kvar till nästa försök.
- Kustoms order-ID står på ordern under Customer › Kustom order ID, med Copy. Det är samma ID som Kustoms portal visar.
- Kustom får BunStacks ordernummer som merchant reference 1. Med ProSmart kopplat kan Kustoms order-ID följa med till ProSmart. Se Vad ordern får med sig.
Fel och var de syns
| Var | Vad du ser |
|---|---|
| Stack › Kustom | ERROR med orsaken från den senaste kontrollen. Varje miljö visar sin egen status. |
| Ordern | Capture, återbetalning och avbryt nekas när orderns miljö inte är ansluten. Meddelandet namnger miljön, se Orderns miljö. |
| Kassan | Kunden ser ett kort besked: kassan är inte aktiverad, valutan fungerar inte för landet, en vara är slut eller landet stöds inte. |
| Abandoned checkouts | promotion failed med Retry promotion: Kustom rapporterade betalt men ordern skapades inte. outcome unknown: BunStack nådde inte Kustom. Kontrollera sessionen i Kustoms portal. |
| Notiser och mejl | En order som inte kunde skapas, eller en olöst session, ger en notis och ett mejl till kontaktadressen. |
En order kan flaggas Needs attention av skäl som rör Kustom. Orsaken står på ordern.
| Orsak | Betyder | Gör så här |
|---|---|---|
| oversold | Kunden betalade för fler enheter än som fanns. Ordern behålls. | Välj att skicka, restnotera eller återbetala. |
| Belopps- eller valutaavvikelse | Kustoms belopp eller valuta skiljer sig från sessionen. Ordern skapas ändå. | Jämför ordern med Kustoms portal innan du skickar. |
| Landsavvikelse | Adressen från Kustom ligger i ett annat land än momsen räknades för. | Kontrollera momsen innan du skickar. |
| fraud pending | Kustoms bedrägerikontroll pågår. Dragningen är spärrad. | Vänta tills Kustom godkänner ordern. |
| fraud rejected | Kustom avvisade ordern i bedrägerikontrollen. | Skicka inte. Avbryt ordern. |
| Kustom cancelled | Kustom avbröt ordern. Reservationen gäller inte längre. | Skicka inte. Avbryt ordern. |
Anropsgränser
- Ny kassasession: 10 per minut per butik och IP-adress.
- Bekräftelsesidan: 10 per minut per Kustom-order.
- Validering och push skyddas av en token, inte av en gräns. Fel token ger svaret 404.