Woo Swish e-commerce

Beskrivning

Vårt tillägg gör det möjligt för dig att acceptera Swish som betalningsmetod i din webshop. Denna betalningsmetod är lämplig om du vill erbjuda dina kunder snabba, enkla och säkra mobilbetalningar.

Förutom detta tillägg behöver du tjänsten ”Swish för handel” som du beställer från någon av de svenska banker som erbjuder denna. Fråga din bank om de gör det. ”Swish för handel” är en speciell tjänst som är utvecklad för e-handel och som skiljer sig från den vanliga privata Swish-tjänsten och även företagstjänsten ”Swish företag”. Vissa banker har gjort det möjligt att beställa tjänsten online i deras Internetbank, men de flesta banker kräver fortfarande att en ifylld och signerad blankett skickas in.

Vårt tillägg stöder tre metoder att koppla. De beskrivs nedan:

Teknisk leverantör

Du kan använda oss som Teknisk leverantör när du ansluter din webshop till banken.

Detta är det enklaste sättet att använda tillägget. Du väljer BjornTech som Teknisk leverantör i din internetbank och konfigurerar tillägget för att använda en Teknisk leverantör.

Läs med om status för Teknisk leverantör i din bank och hur du konfigurerar det i vår guide

Lokalt certifikat

Om din bank inte stöder val av teknisk leverantör så kan du skapa ett eget certifikat och lägga det på din webserver. Instruktioner för detta finns i din installationsmanual.

Simulator

Om du bara vill veta hur tillägget ser ut i din webshop eller om du behöver testa betalningar i din testmiljö, så kan du konfigurera tillägget så att den simulerar betalningar.
En betalning som utförs via simulatorn är gjord med ett förinställt fiktivt mobilnummer och kommer automatiskt att godkännas av systemet. Då kan du se du hur betalningen kommer att se ut i Swish-appen.

Installation

Installationsinstruktioner för teknisk leverantör.

  1. Sök efter och installera tillägget inne i wordpress genom att söka efter ”Swish” under tillägg.
  2. Aktivera tillägget via menyn ”Tillägg” i WordPress.
  3. Beställ ett ”Swish handel”-konto från din svenska bank.
  4. Välj BjornTech som din Tekniska leverantör. Du gör det i din internetbank.
  5. Select ”BjornTech som Teknisk Leverantör” som anslutningstyp.
  6. Ange ditt Swish-nummer i fältet ”Swish-nummer” och din mail-adress i ”Kontots mail-adress”. Spara inställningarna.
  7. Klicka på ”Anslut”

  8. Öppna bekräftelsemailet som vi skickat till din inbox och klicka på aktiveringslänken.

  9. Gör en testbetalning för att bekräfta att allt fungerar.

Installationsinstruktioner för lokalt certifikat.

Stegen nedan kräver teknisk kompetens

  1. Sök efter och installera tillägget inne i wordpress genom att söka efter ”Swish” under tillägg.

  2. Aktivera tillägget via menyn ”Tillägg” i WordPress.

  3. Beställ ett ”Swish handel”-konto från din svenska bank.

  4. Generera privat nyckel och CSR här: http://portal.swish.nu/company/certificates/ (se https://assets.ctfassets.net/zrqoyh8r449h/70IepbShaTPqL3ZBWPeefP/00fbc0eeed701f67fd93a07d08ee219b/Swish_Certificate_Management_Guide_1.6.pdf)

    Using cpanel:

    Välj ”SSL/TLS” vid sektionen ”Security”
    Välj ”Private Keys (KEY)”
    Scrolla ner till ”Generate a New Private Key” and select the key size of 4096.
    Skriv in ”Swish” i ”Description”-fältet klicka ”Generate”
    Välj ”Return to SSL Manager”
    Välj ”Certificate Signing Requests (CSR)”
    I ”Key” fältet, välj det nyckelnamn du valde när du skapade nyckeln. (i vårt exempel var det ”Swish”)

    Mata in följande:

    Domains: namn på din website.xxx
    State: Region
    Country : Sverige
    Company: Ditt företags namn
    Company Division: Avdelning eller lämna blankt
    Email: din@email.se
    Passphrase: Välj lösenord om du vill eller lämna blankt (kom ihåg det och skriv in på Swish-admin)
    Description: En beskrivning eller lämna blankt

    Välj ”Generate”

    kopiera datat från ”Encoded Certificate Signing Request”-fältet och använd det i steg 5 nedan.

    Using MacOs terminal or Linux via SSH:

    $ openssl genrsa -out ./swish.key 4096
    $ openssl req -new -sha256 -key ./swish.key -out ./swish.csr
    

    Mata in följande:

    Country Name (2 letter code) – SE
    State or Province Name (full name) – Region
    Locality Name (eg, city) – Stad
    Organization Name (eg, company) – Ditt företagsnamn
    Organizational Unit Name (eg, section) – Avdelning eller lämna blankt
    Common Name (eg, fully qualified host name) – dinwebsite.namn
    Email Address – din@email.se
    A challenge password – Välj lösenord om du vill eller lämna blankt (kom ihåg det och skriv in på Swish-admin)

  5. Använd datat som du kopierade från cpanel eller filen ”swish.csr” för att skapa ett certifikat på https://comcert.getswish.net/cert-mgmt-web/authentication.html (detta måste göras av teknikpersonen från steg 3)
    Logga på genom att ange ditt personnummer, företagets organisationsnummer och ditt företags swish-nummer (som börjar med 123)
    Klicka på fliken ”new certificate”
    Klistra in innehållet från cpanel eller ”swish.csr”-filen i steg 4 i fältet ”Paste CSR” se till att formatet ”PEM” är valt.
    Klicka på ”Generate” för att skapa certifikatet
    Kopiera det genererade datat och klistra in det i en fil med ändelsen .pem (i vårt exempel swish.pem)

  6. Öppna filen swish.pem och klistra in innehållet från filen swish.key högst upp i filen.
    Kopiera allt (inklusive sidhuvud och sidfot) mellan:
    —–BEGIN RSA PRIVATE KEY—–
    och:
    —–END RSA PRIVATE KEY—–
    och lägg in det före
    —–BEGIN CERTIFICATE—–
    —–END CERTIFICATE—–
    —–BEGIN CERTIFICATE—–
    —–END CERTIFICATE—–
    —–BEGIN CERTIFICATE—–
    —–END CERTIFICATE—–
  7. Placera certifikatet någonstans i serverns filsystem
    Använd FTP eller filhanterare i Cpanel om sådan finns.
    Notera certifikatets kompletta sökvägen och namn.
  8. Konfigurera och aktivera tillägget.
    Välj ”Använd lokalt Swish certifikat” som anslutningstyp
    Mata in platsen för certifikatet från steg 7.
    Om du i steg 4 skapade ditt certifikat med ett lösenord måste du lägga in det i konfigurationspanelen.
    Mata in ditt Swish-Handel nummer (börjar med 123).
    Ändra övriga parametrar om du önskar.
    Spara inställningarna.
  9. Gör en testbetalning för att säkerställa att allt fungerar som det ska.

Vanliga frågor

Q: Jag har ett privat Swish-number (i min Swish-app). Kan jag använda detta nummer för att ta emot betalningar med tillägget.?
A: Nej, du behöver Swish handel. Kontakta din bank för att beställa.
Q: Jag har ett Swish företag nummer (som börjar med 123). Kan jag använda detta nummer i tillägget?
A: Nej, du behöver Swish handel. Kontakta din bank för att beställa.
Q: På tilläggets installationssida står det att mitt system använder NSS. Vad betyder det?
A: Ett mindre antal installationer använder sig av NSS istället för OpenSSL för att hantera certifikat. Din installation är en av dessa. Tillägget kan konfigureras för att fungera med NSS men kräver djup kunskap om NSS. Om du inte har denna kunskap rekommenderar vi dig att använda oss som Teknisk leverantör istället.

Recensioner

19 oktober 2020
Great plugin and great support. Swish is very popular in Sweden and our customers are loving it.
6 september 2019
Fast and personal support. Elegant code, easy to debug. Error handling of backwards WC compatibility could be better.
21 augusti 2019
Excellent plugin for Swish with very fast and excellent support from the developer.
Läs alla 14 betyg

Bidragsgivare och utvecklare

”Woo Swish e-commerce” är programvara med öppen källkod. Följande personer har bidragit till detta tillägg.

Bidragande personer

”Woo Swish e-commerce” har översatts till 1 språk. Tack till översättarna för deras bidrag.

Översätt ”Woo Swish e-commerce” till ditt språk.

Intresserad av programutveckling?

Läs programkoden, kika på SVN-filförvaret eller prenumerera på utvecklarloggen via RSS.

Ändringslogg

3.4.0

  • Bekräftat att pluginet fungerar med WooCommerce 5.7
  • La till Swish Authorization token till inställningssidan
  • Fix: Ändrade translation domain för tack-meddelandet från Swish.

3.3.3

  • Verified to work with WooCommerce 5.6
  • Fix: Retrieving a Swish-payment with the ”Retrieve” button failed because a faulty call.

3.3.2

  • Fix: Faulty call when starting background check for pyments caused the status payment status page not to update in some cases.

3.3.1

  • Verified to work with WordPress 5.8 and WooCommerce 5.5
  • Fix: Changed ’swish-completed’ from id to class.
  • Fix: Added logging of data sent to the Swish service.
  • Fix: Error was not logged correctly the transaction sent to Swish could not be formatted.

3.3.0

  • Verified to work with WooCommerce 5.3
  • Fix: Klarna is setting payment-reference also on Swish-orders created by us, this caused payments not to be marked as PAID.
  • Fix: In some cases the order retrevial process when handling callbacks fails due to the use of a order-child.
  • Fix: The settings page did not load correclty in some browsers.

3.2.0

  • New: Improved handling of callbacks. Sites with performance issues did not respond within Swish timeout time causing callbacks to fail in processing.
  • New: Implemented a status check for transaction-status in order to give customers correct info also when Swish callback fails. Now the plugin asks Swish on transaction status every 10:th second on an ongoing transaction.

3.1.0

  • Verified to work with WooCommerce 5.1
  • Verified to work with WordPress 5.7
  • Fix: Minor clean-up of the Swish-number field.
  • Fix: Removing url parameters from url before loading image.
  • Fix: Callback for refunds was not correctly processed.
  • Fix: Fatal error when refunding caused by logging function.
  • New: Added the possibility to set a placeholder for the Swish-number field.
  • New: Sending webhooks through service in order to get better trouble-shooting capabilities.

3.0.9

  • Verified to work with WordPress 5.6
  • Verified to work with WooCommerce 4.8
  • Fix: Improved error handling when connecting to the Swish-service

3.0.8

  • Fix: Handle only one parameter instead of two in the filter ’woocommerce_gateway_icon’ to handle the situation where other gateways are using only one.

3.0.7

  • Fix: Jquery was using class instead of if causing order details not to show when payment is ready
  • Verified to work with WooCommerce 4.7

3.0.6

  • Fix: Order-id not found in checkout if url was using fragment identifier (#)

3.0.5

  • Fix: Some sites did not accept PUT calls for admin, resulting in problems when connecting to service.
  • Fix: The Swish-simulator connection type did not work after 3.0.0
  • Fix: Error handling in two funxtions did use the wrong logging functions.
  • Fix: Check payment reference for unwanted characters and lenght.
  • Fix: Moved back to old callback handling

3.0.2

  • Fix: Incorrect creation of UUID caused payment to generate error because of an incorrect payment reference

3.0.1

  • Fix: Swish checkoutbild visades inte för kunder i alla teman.

3.0.0

  • Nytt: ** VIKTIGT ** Forcerar användandet av TLS 1.2 – Swish kräver detta från 2020-11-01. Ett felmeddelande visas om din site inte stödjer TLS 1.2, Kontakta ditt webhotell om du behöver lösa detta.
  • Verifierad att fungera med WooCommerce 4.6
  • Nytt: Förändrad checkout funktion som inte visar orderdetaljer förrän betalningen är klar.
  • Nytt: Möjlighet att sätta minimiålder för köp på hela websiten.
  • Nytt: Möjlighet att sätta miniålder för köp på produkter.
  • Nytt: Använder WooCommerce REST api funktioner för callbacks.
  • Nytt: Adderade ett filter för att användare av lokala certifikat skall kunna lägga till parametrar i CURLOPT om nödvändigt.
  • Fix: Ändrat sättet för att hämta callback-url så att det fungerar med WPML permalänkar.
  • Fix: Inställningssidan gav ett felmeddelande när ändringar sparades.

2.5.2

  • Verifierad att fungera med WooCommerce 4.4
  • Fungerar med WordPress 5.5

2.5.1

  • Fix: I vissa installationer visades felaktiga återbetalnings-meddelanden. Ändrat logiken för hur återbetalning hanteras.

2.5.0

  • Nytt: Adderade en funktion för att hämta en betalning i det fall att Swish callback inte fungerar.
  • Fix: En felaktig hantering av Swish callback orsakade att återbetalningsmeddelanden loggades på korrekta betalningar. Vänligen bortse från dessa meddelanden.

2.4.1

  • Fix: Nytt nummer och nya certifikat för test-servicen.

2.4.0

  • New: SEB och Danske bank tillagda till teknisk leverantör.
  • Fix: Aktivering av teknisk leverantör misslyckades i vissa fall.
  • Fix: Multipla återbetalningar fungerar inte
  • Fix: Order sätts alltid i ”pending” när den skickas.

2.3.2

  • Verifierad för att fungera med WooCommerce 4.0
  • Verifierad för att fungera med WordPress 5.4

2.3.1

  • Fix: Pluginet behöver inte ladda textdomain, det gör WordPress automatiskt
  • Fix: Bättre matchning av order id från checkout-sidan för att undvika att ordern inte hittas om något annat plugin har förändrat checkout-url.
  • Rättelse: Tillägget försökte alltid leta efter en certifikatsfil. Detta orsakade fel och loggmeddelanden om inget certifikat användes.

2.3.0

  • Verifierat att fungera med WooCommerce 3.9.
  • Ny: Lagt till inställning som tillåter att namnet för Swish-nummer fältet går att ändra.
  • Fix: Texten med orsak till återbetalning kontrollerades inte vad gäller längd och otillåtna tecken. Detta kunde orsaka att återbetalningar misslyckades.
  • Fix: Texten som används vid testmode gick inte att översätta.

2.2.2

  • Nytt: Teknisk leverantör fungerar för Handelsbanken

2.2.1

  • Fix: Den modala informationen visades inte vid anslutning till Teknisk leverantör.
  • Fix: Ytterligare CSS-förändringar för att få Swish-logotypen att visas i korrekt storlek i all teman.

2.2.0

  • Verifierad att fungera med WordPress 5.3 och WooCommerce 3.8
  • Nytt: Lagt till en möjlighet att välja vilken status en färdig order skall ha.
  • Fix: Swish logo i modal blir ibland VÄLDIGT stor. Ändrat i CSS för att säkerställa att storleken blir normal.
  • Fix: Lagt till ett meddelande till slutkund som visas om någonting går fel vid kontroll om betalning tagits emot.

2.1.0

  • Nytt: Val av teknisk leverantör fungerar för Nordea
  • Nytt: Order-id sparas alltid som metadata.
  • Nytt: Swish betalningsreferens sparas aktivt när Swish callback görs.
  • Nytt: Loggning av certifikatsdetaljer.
  • Nytt: Varningstext visas när certifikatet från Swish är på väg att gå ut.
  • Fix: Vid användande av plugin från Learndash sattes ordern till färdigbehandlad oavsett om betalningen lyckades eller inte,
  • Fix: Under vissa förhållanden visades inte bilden med Swish logotyp i modal checkout.
  • Fix: Vid användande av en alternativ checkout-url kunde orsaka ”Okänt fel från Swish”.
  • Fix: Statusmeddelanden för BankID tillagda.

2.0.9

  • Fix: Mindre textändringar
  • Verifierad att fungera med WooCommerce 3.7.0

2.0.8

  • Fix: Tydligare felmeddelanden vid de fall Teknisk leverantör inte är vald hos Banken.
  • Fix: Fler kontroller av Swish-nummer vid anslutning till Swish tjänsten

2.0.7

  • Rättelse: Vissa översättningar laddades inte upp korrekt till WordPress.

2.0.6

  • Fix: Konfigureringar från föregående version blev inte korrekt konverterade.

2.0.5

  • Ny: Certifikatservicen tillagd. Inget lokalt certifikat behövs för kunder till Swedbank (fler banker kommer snart).
  • Nytt: Ny modal checkout, välj den på konfiguratoinssidan. Den fungerar inte med alla teman. Kontakta oss om du har problem med ditt tema.