Stripe Betalning

Stripe är en internationell betalleverantör. Med den här appen skickas kunden till Stripes egen betalsida för att slutföra betalningen, och kommer sedan tillbaka till er butik med en orderbekräftelse.

Vilka betalsätt kunden får välja mellan – kort, Klarna, Swish, Apple Pay, Google Pay – bestämmer ni i Stripe, inte i Ashop. Slår ni på ett nytt betalsätt i Stripes kontrollpanel dyker det upp i kassan utan att något behöver ändras här.

Förutsättningar

• Ett Stripe-konto med er verksamhet godkänd.
• Butiken säljer i svenska kronor och levererar till svenska adresser. Stripe-kassan är uppsatt för den svenska marknaden – säljer ni till andra länder behöver ni ett annat betalsätt för dem.

Kom igång

1. Hämta era nycklar i Stripe

Ni behöver två uppgifter från Stripes kontrollpanel:

• Secret API key – under Utvecklare → API-nycklar. Börjar på sk_live_ för skarpt läge och sk_test_ för testläge.
• Secret webhook key – den signeringshemlighet ni får när ni lägger upp webhooken i nästa steg. Börjar på whsec_.

2. Lägg upp webhooken i Stripe

Det här steget är nödvändigt och missas ofta. Webhooken är det som gör att ordern blir klar även om kunden stänger webbläsaren direkt efter betalningen.

Skapa en webhook i Stripe under Utvecklare → Webhooks med:

• Adress: er butiksadress följt av /checkout/stripe/callback – exempelvis https://erbutik.se/checkout/stripe/callback
• Händelse: checkout.session.completed

Kopiera signeringshemligheten som Stripe visar och spara den som Secret webhook key.

3. Fyll i uppgifterna i Ashop

Öppna appen Stripe via Appar och fyll i båda nycklarna. Båda krävs.

4. Betalsättet i kassan

Själva betalsättet – det kunden ser i kassan – läggs upp av Ashop. Mejla supporten när nycklarna är på plats, och berätta vad betalsättet ska heta för kunden och om det ska visas för privatpersoner, företag eller båda.

Därefter styr ni namn, beskrivning och om betalsättet är aktivt under Inställningar → Betalsätt.

Lämna avgiften på 0. En avgift på Stripe-betalsättet tas inte ut av Stripe – kunden betalar den inte, och den kommer inte in på ordern. Behöver ni ta betalt för betalsättet får det byggas in i frakt eller pris i stället.

Så upplever kunden det

1. Kunden fyller varukorgen och går till kassan.
2. Kunden väljer Stripe och klickar Vidare till betalning.
3. Kunden skickas till Stripes betalsida, väljer betalsätt och fyller i adress och telefonnummer.
4. Efter godkänd betalning skickas kunden tillbaka till er butiks kvittosida och får sin orderbekräftelse.

Två detaljer värda att känna till:

• Företagskunder får fylla i Företagsnamn och Organisationsnummer på Stripes sida. Uppgifterna följer med till ordern i Ashop.
• Långa produktnamn kortas till 40 tecken på Stripes betalsida. Namnet i er butik och på orderbekräftelsen påverkas inte. Har ni långa namn kan det vara värt att kontrollera att de går att känna igen även avkortade.
• Rabattkoder visas som ett lägre pris på Stripes sida, inte som en egen rabattrad. Summan blir rätt, men kunden ser inte rabatten specificerad där. Den syns däremot på orderbekräftelsen.

Vad som händer med ordern

Ordern skapas i Ashop redan innan kunden skickas till Stripe, men som en preliminär order som inte syns i orderlistan. När betalningen är godkänd:

• ordern fylls på med kundens uppgifter från Stripe,
• orderbekräftelse skickas till kunden och ordernotis till er,
• lagret uppdateras,
• ordern får status Mottagen och dyker upp i orderlistan som vanligt.

Om kunden stänger webbläsaren direkt efter betalningen sköts allt detta i stället av webhooken, inom någon minut. Det är därför webhooken måste vara upplagd – utan den kan en betald order bli liggande utan bekräftelse.

Återbetalningar sker i Stripe

Detta är viktigt. Ashop skickar ingenting till Stripe när ni annullerar eller krediterar en order. Ska kunden ha pengar tillbaka måste ni:

1. göra återbetalningen i Stripes kontrollpanel, och
2. hantera ordern i Ashop – annullera eller kreditera – så att er statistik och ert lager stämmer.

Det finns ingen knapp i Ashop för att återbetala eller häva en Stripe-betalning. Bygg in dubbelheten i er rutin, annars är risken stor att en kund får varan krediterad utan att få pengarna, eller tvärtom.

Följa upp en order

På ordern i Ashop visas Stripes egen status, hämtad direkt från Stripe:

Går Stripe inte att nå visas ´Kunde ej nå PSP´ med felmeddelandet. Ordern påverkas inte av det – det är bara statusvisningen som inte kunde hämtas.

Ordrar som behöver hanteras manuellt

Om summan hos Stripe och summan i Ashop skiljer sig får ordern statusen Behöver hanteras och en kommentar: ´Ordersumman i Ashop stämmer inte med ordersumman hos Stripe. Ordern behöver hanteras manuellt.´

Då ska ni jämföra ordersumman i Ashop med betalningen i Stripe innan ni skickar varan. Det är ovanligt, men det är ett medvetet skyddsnät – hoppa inte över det.

Testa innan ni går live

1. Lägg in era testnycklar från Stripe (sk_test_ plus webhookhemligheten för testläget).
2. Lägg en testorder med Stripes testkortnummer.
3. Kontrollera att kunden kommer tillbaka till kvittosidan, att orderbekräftelsen skickas, och att ordern får status Mottagen.
4. Byt till era skarpa nycklar och lägg en riktig liten order som ni sedan återbetalar i Stripe.

Ashop visar inte om ni kör i test- eller skarpt läge – det avgörs helt av vilka nycklar som ligger inne. Var noga när ni byter, och kontrollera i Stripe att betalningarna landar i rätt läge.

Felsökning