Ecster Pay för WooCommerce

Introduktion

Ecster Pay för WooCommerce är en betalmodul som låter dig ta betalt via Ecsters nya betalsystem Ecster Pay i din Woocommerce-butik.

Modulen är nylanserad

För tillfället är modulen precis nylanserad. Eventuella buggar, frågor eller förslag på ändringar kan rapporteras till info@krokedil.se.

Betalfönstret för Ecster Pay integreras/visas direkt i din webbutik via en iframe-lösning. Detta innebär att visningen av iframen kan variera mellan olika teman. I vissa teman kan visningen komma att se konstig eller felaktig ut. Detta beror då på att markupen i temat skiljer sig från WooCommerce’s ordinarie markup. Kontakta oss för närmare info om betalfönstret visas på ett felaktigt sätt i ditt tema.

 

Konto hos Ecster

För att komma igång med Ecster Pay behöver du ett konto hos Ecster. Om du inte är kund hos dem idag kan du registrera dig här.

Testkonto

Om du vill testa modulen före du gör riktiga köp så kan du använda dig av följande testkontouppgifter:

Test username: yGZ8mH
Test password: VtzQMZG7ndTXacf9juDMMz6A7rR5jdDX

Du kan även skapa ett eget testkonto till dig själv hos Ecster.

Tillsammans med de uppgifter du använder behöver du även aktivera Testmode i modulen för att kunna göra testköp.

För att göra testköp behöver du även använda testuppgifter som kund i kassan. Använd personnummer 651106-3155 i Mobilt Bank ID för att göra ett vanligt testköp.

OBS! För att ett testköp ska kunna genomföras kan inte den totala summan sluta på siffran 8 eller 9.

Installation

  1. Logga in i WordPress Admin. Navigera till → PluginsLägg till nytt i vänstermenyn.
  2. Klicka på Ladda upp tillägg och därefter Välj fil för att bläddra dig fram till zip-filen på din dator. Klicka därefter på OK och slutlingen på knappen Installera nu.
  3. Aktivera pluginet.

Obligatoriska inställningar i WordPress

För att callback-funktionen (kommunikationen från Ecster tillbaka till din butik) ska fungera så behöver du tänka på följande:

  • Permalänksinställningarna får inte vara inställd på Förvald. Något av de övriga alternativen måste väljas (mod_rewrite behöver vara aktiverat, annars genererar callbacken från Ecster en 404).
  • Callbacks fungerar inte om du har en testmiljö som ej är publikt nåbar. Om du jobbar i en lokal utvecklingsmiljö rekommenderar vi att du använder dig av en tjänst som ngrok eller liknande.

Valuta med två decimaler

För att priser och momssatser på produkter ska skickas över korrekt från WooCommerce till Ecster behöver du i valutainställningarna i WooCommerce ange att din butik ska visa valuta med två (2) decimaler. Detta gör du under → WooCommerce → Inställningar och fliken Generellt.

Om du inte gillar upplägget att visa heltalspriser med 2 decimaler (dvs 200,00 kr) så kan du undvika det (dvs visa det som 200 kr) genom följande kodsnutt:

Mer info om orsaken till varför man behöver ange priser med två decimaler hittar du i vår bloggpost här.

Konfiguration

  1. Navigera till → WooCommerce → Inställningar → Kassan.
  2. Nu visas Ecster Pay som tillgänglig betalmetod i den horisontella menyn högst upp. Klicka på denna länk för att komma till inställningssidan för betalmetoden.
  3. Enable/disable – Kryssa i checkboxen om du vill att betalmetoden ska vara tillgänglig i kassan.
  4. Title – Här anger du titeln för betalmetoden som visas i kassan och i orderbekräftelser.
  5. Description – Här anger du beskrivning av betalmetoden som visas i kassan.
  6. Test mode – Kryssa i checkboxen om du gör köp med ett testkonto.
  7. Live username – Ditt username som du fått från Ecster.
  8. Live password – Ditt password som du fått från Ecster.
  9. Test username – Ditt username för test som du fått från Ecster.
  10. Test password – Ditt password för test som du fått från Ecster.
  11. Logging – Logga händelser i modulen. Loggen hittar du genom att navigera till → WooCommerce → Systemstatus → Loggar.

Orderflödet i pluginet

Eftersom Ecster Pay är en inbäddad kassa så behöver orderdata skickas från WooCommerce till Ecster före kassasidan renderas. Så som logiken i pluginet är gjord nu så innebär det att en order även skapas i WooCommerce i samband med att kunden identifierar sig i Ecsters kassa.

Orderprocessen ser ut på följande vis:

  1. Kassasidan i WooCommerce anropas.
  2. Information om ordern/varukorgen skickas till Ecster.
  3. Ecster returnerar info om den pågående transaktionen samt själva Ecster Pay-kassan (som en html-sträng).
  4. Kassasidan renderas och Ecster-kassan visas.
  5. Kunden identifierar sig i Ecsters kassa.
  6. Ett anrop skickas från Ecster till webbutiken innehållande kundens adressuppgifter. En order skapas nu i WooCommerce. Adressuppgifterna sparas i ordern och orderstatus i WooCommerce sätts till Inväntar betalning (Pending). I detta läge visas den i WooCommerce ordervy men är ännu inte betald.
  7. Om uppdateringen av land/postnummer innebär en ändring av ex fraktkostnad så uppdateras varukorgen/ordern i WooCommerce och transaktionen i Ecsters system.
  8. När kunden klickar på Betala i Ecsters kassa laddas kassasidan om och pluginet processar ordern i WooCommerce (inklusive att posta WooCommerce’s eget kassaformulär).
  9. Orderstatus ändras till Behandlas (Processing) i WooCommerce och ett mail med orderbekräftelse skickas från WooCommerce till kund.

Vad händer om en kund inte genomför köpet?

Om en kund har identifierat sig i Ecsters kassa men sedan väljer att inte genomföra köpet, då kommer ordern att ligga kvar i WooCommerce med status Inväntar betalning. Om du har har aktiverat funktionen Reservera lagersaldo i WooCommerce inställningar (–> WooCommerce –> Inställningar –> Produkter –> Lagersaldo) så kan orderstatus automatiskt ändras till Avbruten efter det antal minuter du anger i inställningarna. Om du inte har aktiverat funktionen Reservera lagersaldo kommer ordern att ligga kvar med orderstatus Inväntar betalning ända tills att du själv manuellt ändrar eller raderar den.

Felsökning

Om kassan inte visas efter att du har följt instruktionerna (och du inte får upp något felmeddelande i kassan) så rekommenderar vi att du tillfälligt sätter WP_DEBUG till true i wp-config.php. Läs mer om debugging i WordPress här. Därefter kan du rapportera in felet till oss så hjälper vi dig vidare.

Före du går live

När du är klar med installation och konfiguration behöver din webbutik uppfylla ett antal kriterier före Ecster godkänner butiken.

  1. Gästköp behöver vara aktiverat i WooCommerce (kryssa i rutan Aktivera gästköp under → WooCommerceInställningarTill kassan).
  2. Ecster Pay ska vara det förvalda betalsättet i kassan (justeras i stycket Betalmoduler under → WooCommerceInställningarTill kassan).
  3. Eftersom det tänkta kassaflödet ska vara så friktionsfritt som möjligt så rekommenderar Ecster att Möjliggör registrering i kassan avmarkeras (under → WooCommerceInställningarKundkonton).
  4. Ecster Pay-loggan ska finnas på webbshopens startsida (exempelvis i sidfoten). Logotyp kan hämtas härifrån.
  5. Ecster har även en checklista med punkter som berör juridik, priser och villkor. Stäm även av med denna lista före du går live.