Købsflowet

Flowet er det samme uanset frontend: find varer → kurv → fragt → checkout → betaling → ordre.

1. Katalog#

Hent produkter og varianter for shoppen. Varianter er valgbare muligheder som størrelse og farve. Priser leveres i mindste enhed (...Minor).

2. Kurv#

Kurven er knyttet til en kurv-token, så gæster kan handle uden konto. Prisen er altid live: serveren regner moms og total, og tjekker lager. En gæstekurv kan flettes ind i kundens kurv ved login.

3. Fragt#

Frontenden beder om mulige leveringsmåder for kurvens adresse (POST /cart/shipping-options). Fragtprisen sættes af serveren og indgår i totalen.

4. Betalingsmuligheder#

Et endpoint (payment-options) fortæller, hvilke betalingsmetoder shoppen tilbyder (fx kort eller betaling ved levering).

5. Checkout#

Checkout oprettes med:

• acceptTerms: true – kunden har accepteret vilkårene.
• acceptedTotalMinor – den total kunden så. Hvis serverens total er en anden, afvises købet i stedet for at kunden betaler et uventet beløb.
• en idempotens-nøgle – gentagne klik giver aldrig dobbelte ordrer.

Ved oprettelsen reserveres lageret (60 minutter) og ordren frosses: priser, moms, fragt og returpolitik ændres ikke bagefter.

6. Betaling og bekræftelse#

Ordren står som pending_payment, indtil udbyderen bekræfter betalingen. Se Betaling. Når bekræftelsen kommer, bliver ordren confirmed.

7. Ordre og kvittering#

Kunden får et ordre-link (en token), hvor ordren kan ses, en kvittering hentes og en fortrydelse startes. Se Kvittering og Fortrydelse.

Fejl#

Fejl returneres som afvisninger med kode (fx unknown_municipality ved en ugyldig kommune). En komplet fejlkodeliste kommer med OpenAPI-specen Planlagt.