- Identifiants API
- Numéro Swish
- Certificat (PEM)
- Clé privée (PEM)
Configurez Swish pour que vos clients paient sur votre page de réservation avec un code QR et BankID, directement sur votre compte bancaire. Avant de commencer, il vous faut :
- ✓Un compte bancaire professionnel suédois.
- ✓Une personne disposant de Mobile BankID, qui sera votre contact pour le certificat.
- ✓Quelqu’un qui sait lancer une commande sur un ordinateur.
Commander Swish Handel à votre banque
Demandez Swish Handel, le contrat Swish pour les sites web, à la banque de votre entreprise, et désignez votre contact pour le certificat. Votre banque vous donne ensuite votre numéro Swish : dix chiffres commençant par 123.
Créer votre certificat Swish
La création du certificat prend environ 15 minutes.
- 1
Créez une clé et une demande de signature
Lancez cette commande dans un terminal, en remplaçant 5566778899 par votre numéro d’organisation et 1231234567 par votre numéro Swish :
openssl req -newkey rsa:4096 -nodes -keyout swish-private.key -out swish.csr -subj "/C=SE/O=5566778899/CN=1231234567"
Elle crée swish.csr, votre demande de signature, et swish-private.key, votre clé privée. Gardez la clé pour vous : c’est l’identité de votre entreprise chez Swish.
- 2
Connectez-vous au portail Swish
Votre contact pour le certificat ouvre portal.swish.nu, saisit votre numéro d’organisation et votre numéro Swish, puis valide avec Mobile BankID.
- 3
Collez la demande de signature
Ouvrez swish.csr dans un éditeur de texte et copiez-en tout le contenu, lignes BEGIN et END comprises. Collez-le dans le champ CSR de l’onglet New certificate.
- 4
Générez le certificat
Choisissez PEM comme format et le BIC de votre banque comme émetteur, puis générez-le.
- 5
Enregistrez le certificat
Copiez tout le texte du certificat affiché par le portail, de la première ligne BEGIN CERTIFICATE à la dernière ligne END CERTIFICATE. Enregistrez-le dans un éditeur de texte sous le nom swish-cert.pem.
Ajouter Swish dans TourTask
- 1
Ouvrez la carte Swish
Allez dans Configuration → Options de paiement et cliquez sur la carte Swish sous Paiements en ligne → Passerelles de paiement. Elle n’y est pas ? Choisissez Afficher toutes les passerelles sous les cartes.
- 2
Choisissez le pays et la devise
Dans Pays, choisissez le pays de votre compte Swish et de son compte bancaire, et dans Devise, la devise dans laquelle les voyageurs paient. Cliquez sur Ajouter. Pour modifier l’un ou l’autre plus tard, retirez Swish avec Retirer puis ajoutez-le à nouveau.
- 3
Saisissez vos identifiants API
Sous Authentification, la carte a un champ pour chacun :
Numéro Swish
Certificat (PEM)
Clé privée (PEM)Chaque champ est enregistré dès que vous cliquez en dehors.
- 4
Activez Swish
Cliquez sur Activer une fois tous les champs remplis. La carte passe à Actif et les voyageurs peuvent payer avec Swish sur votre page de réservation. Chaque paiement arrive directement sur votre propre compte Swish : TourTask ne détient jamais votre argent.
Tester avec un petit paiement réel
Swish n’a pas de mode test : testez-le tout de suite avec un petit paiement réel.
- 1
Réservez votre visite la moins chère
Sur votre propre page de réservation, choisissez Swish et payez avec l’application Swish de votre téléphone.
- 2
Vérifiez la réservation
Elle apparaît comme payée dès que vous validez, et l’argent est sur votre compte bancaire.
- 3
Remboursez le paiement
Dans la réservation, choisissez Rembourser le paiement dans le menu d’actions ⋮ du paiement. Cliquez sur Rembourser le reste, puis sur Rembourser via Swish, puis sur Sauvegarder.
Renouveler votre certificat Swish
Un certificat Swish dure généralement environ deux ans. À son expiration, les paiements Swish s’arrêtent, et TourTask ne vous prévient pas.
Notez dans votre agenda la date d’expiration indiquée sur le portail Swish, avec un rappel quelques semaines avant. Pour le renouveler, créez un nouveau certificat de la même façon, puis collez-le dans TourTask avec sa nouvelle clé privée.
Questions fréquentes
Oui, s’il relève d’un contrat Swish Handel. Passez alors l’étape de la banque et commencez par le certificat.
Non. Swish encaisse toujours en SEK, et TourTask convertit le total de la réservation en SEK.
Jusqu’à 13 mois après le paiement, en totalité ou en partie. Après Annuler la réservation, TourTask ne peut plus le rembourser via Swish.
Demandez à votre banque le coût de Swish Handel avant de signer. Les prix de TourTask figurent sur la page des tarifs.