- API-toegangsgegevens
- Swish-nummer
- Certificaat (PEM)
- Privésleutel (PEM)
Stel Swish zo in dat klanten op je boekingspagina betalen met een QR-code en BankID, rechtstreeks op je bankrekening. Voordat je begint, heb je nodig:
- ✓Een Zweedse zakelijke bankrekening.
- ✓Iemand met Mobile BankID als contactpersoon voor je certificaat.
- ✓Iemand die één opdracht op een computer kan uitvoeren.
Swish Handel bestellen bij je bank
Vraag je zakelijke bank om Swish Handel, de Swish-overeenkomst voor websites, en geef je contactpersoon voor het certificaat op. Je bank geeft je dan je Swish-nummer: tien cijfers die beginnen met 123.
Je Swish-certificaat maken
Het certificaat maken duurt ongeveer 15 minuten.
- 1
Maak een sleutel en een ondertekeningsverzoek aan
Voer deze opdracht uit in een terminal, met je organisatienummer in plaats van 5566778899 en je Swish-nummer in plaats van 1231234567:
openssl req -newkey rsa:4096 -nodes -keyout swish-private.key -out swish.csr -subj "/C=SE/O=5566778899/CN=1231234567"
Die maakt swish.csr, je ondertekeningsverzoek, en swish-private.key, je privésleutel. Houd de sleutel geheim: hij is de identiteit van je bedrijf bij Swish.
- 2
Log in op het Swish-portaal
Je contactpersoon voor het certificaat opent portal.swish.nu, vult je organisatienummer en Swish-nummer in en keurt goed met Mobile BankID.
- 3
Plak het ondertekeningsverzoek
Open swish.csr in een teksteditor en kopieer de hele inhoud, met de regels BEGIN en END. Plak die in het CSR-veld op het tabblad New certificate.
- 4
Genereer het certificaat
Kies PEM als formaat en de BIC van je bank als uitgever, en genereer het dan.
- 5
Sla het certificaat op
Kopieer alle certificaattekst die het portaal toont, van de eerste regel BEGIN CERTIFICATE tot de laatste regel END CERTIFICATE. Sla die in een teksteditor op als swish-cert.pem.
Swish toevoegen in TourTask
- 1
Open de kaart van Swish
Ga naar Configuratie → Betaalmogelijkheden en klik onder Online betalingen → Betalingsgateways op de kaart Swish. Staat hij er niet bij? Kies Toon alle gateways onder de kaarten.
- 2
Kies het land en de valuta
Kies bij Land het land waar je account bij Swish en de bijbehorende bankrekening zijn, en bij Munteenheid de valuta waarin reizigers betalen. Klik op Toevoegen. Wil je een van beide later wijzigen, verwijder Swish dan met Verwijderen en voeg het opnieuw toe.
- 3
Vul je API-toegangsgegevens in
Onder Authenticatie heeft de kaart voor elk een veld:
Swish-nummer
Certificaat (PEM)
Privésleutel (PEM)Elk veld wordt opgeslagen zodra je erbuiten klikt.
- 4
Activeer Swish
Klik op Activeren zodra alle velden zijn ingevuld. De kaart wordt Actief en reizigers kunnen op je boekingspagina met Swish betalen. Elke betaling komt rechtstreeks op je eigen account bij Swish: TourTask houdt je geld nooit vast.
Testen met een kleine echte betaling
Swish heeft geen testmodus: test het meteen met één kleine echte betaling.
- 1
Boek je goedkoopste tour
Kies op je eigen boekingspagina Swish en betaal met de Swish-app op je telefoon.
- 2
Controleer de boeking
Die staat als betaald zodra je goedkeurt, en het geld staat op je bankrekening.
- 3
Betaal het bedrag terug
Kies in de boeking Betaling terugbetalen in het actiemenu ⋮ van de betaling. Klik op Rest terugbetalen, daarna op Terugbetalen via Swish en dan op Opslaan.
Je Swish-certificaat vernieuwen
Een Swish-certificaat is meestal ongeveer twee jaar geldig. Verloopt het, dan stoppen de Swish-betalingen, en TourTask waarschuwt je niet.
Zet de vervaldatum uit het Swish-portaal in je agenda, met een herinnering een paar weken van tevoren. Maak voor het vernieuwen op dezelfde manier een nieuw certificaat en plak het samen met de nieuwe privésleutel in TourTask.
Veelgestelde vragen
Ja, als het bij een Swish Handel-overeenkomst hoort. Sla dan de bank over en begin met het certificaat.
Nee. Swish rekent altijd af in SEK, en TourTask rekent het boekingstotaal om naar SEK.
Tot 13 maanden na de betaling, geheel of gedeeltelijk. Na Boeking annuleren kan TourTask de betaling niet meer via Swish terugbetalen.
Vraag je bank wat Swish Handel kost voordat je tekent. De prijzen van TourTask zelf staan op de prijspagina.