Swish
Introduction
En phase piloteSwish est un système bancaire en temps réel basé sur une application suédoise.
Avec plus de 8,7 millions d'utilisateurs actifs et proposé par une grande majorité de détaillants, c'est de loin la méthode de paiement mobile la plus populaire en Suède.
En liant leur compte bancaire au réseau Swish, vos clients peuvent recevoir et transférer des fonds facilement en temps réel.
Vous envoyez une requête standard à notre plateforme pour ouvrir l'application Swish sur les appareils mobiles de vos clients.
L'intégration est très simple, car vous n'avez qu'à envoyer un paramètre supplémentaire avec votre requête.
Activation
- Signer un contrat avec Swish et recevoir en retour des identifiants d'activation.
- Envoyez les identifiants d'activation (SwishID) à notre plateforme ou saisissez-les dans le Merchant Portal et activez Swish comme indiqué dans notre guide.
Suède
Intégration
Redirigez vos clients vers l'application Swish via les modes d'intégration Hosted Checkout Page ou Server-to-server.
Trouvez une vue d'ensemble dans le chapitre "Cinématique".
Ajoutez les propriétés suivantes à une requête standard CreateHostedCheckout/CreatePayment :
{
"redirectPaymentMethodSpecificInput": {
"paymentProductId": 350
},
"order": {
"amountOfMoney": {
"amount": 150,
"currencyCode": "SEK"
}
}
}| Propriétés | Description |
|---|---|
|
order.amountOfMoney |
amount : le montant brut que vous souhaitez facturer pour cette commande. |
|
redirectPaymentMethodSpecificInput.paymentProductId |
paymentProductId : l'identifiant numérique du moyen de paiement sur notre plateforme. Retrouvez cet identifiant dans le chapitre "Aperçu". Pour les paiements demandés via CreateHostedCheckout, il ordonne à notre plateforme d'afficher le code QR pour ouvrir l'application Swish sur la Hosted Checkout Page. Si omis, notre plateforme envoie vos clients à Hosted Checkout Page, leur permettant de choisir ceci ou tout autre moyen de paiement actif dans votre compte. |
Si vous envoyez des requêtes CreatePayment, la réponse de notre plateforme contiendra les propriétés
merchantAction.showFormData.paymentProduct350.paymentRequestToken et merchantAction.showFormData.paymentProduct350.appSwitchLink. Selon le ou les 'appareil(s) utilisé(s) par vos clients, vous devrez utiliser l'une ou l'autre de ces options dans le flux de paiement suivant :
- Avec un ordinateur de bureau et un appareil mobile : créez un code QR sur votre page de paiement en utilisant
merchantAction.showFormData.paymentProduct350.paymentRequestToken. Lors de cette opération, assurez-vous de suivre la documentation Swish. - Avec un appareil mobile : ouvrez l'application Swish sur les appareils mobiles de vos clients en les redirigeant vers
merchantAction.showFormData.paymentProduct350.appSwitchLink.
Consultez le chapitre "Cinématique" pour en savoir plus sur ces scénarios.
Cinématique
Selon le ou les appareil(s) utilisé(s) par vos clients, des différences s'appliquent :
Avec un ordinateur de bureau et un appareil mobile
- Vos clients finalisent une commande sur leur ordinateur de bureau dans votre boutique et sélectionnent Swish.
- Vous envoyez cette requête CreateHostedCheckout/CreatePayment à notre plateforme.
- Sur l'ordinateur de bureau, vous redirigez vos clients via le redirectUrl vers la Hosted Checkout Page (pour les requêtes CreateHostedCheckout) ou affichez un code QR sur votre page de paiement en utilisant lemerchantAction.showFormData.paymentProduct350.paymentRequestToken de notre réponse (pour les requêtes CreatePayment).
- Vos clients scannent le code QR affiché avec leur appareil mobile/tablette.
- L’appareil mobile/tablette ouvre l’application Swish. Vos clients confirment le paiement dans l’application.
- Nous recevons le résultat de la transaction.
- L’appareil mobile/tablette affiche le résultat de la transaction dans l’application Swish ou dans l’application bancaire prenant en charge Swish.
- Sur l'ordinateur de bureau, nous redirigeons vos clients vers votrereturnUrl.
- Vous demandez le résultat de la transaction à notre plateforme via GetPaymentDetails ou GetHostedCheckout, ou vous recevez le résultat via des webhooks.
- Si la transaction a réussi, vous pouvez livrer les biens ou le service.
Avec un appareil mobile
- Vos clients finalisent une commande sur leur appareil mobile dans votre boutique et sélectionnent Swish.
- Vous envoyez cette requête CreateHostedCheckout/CreatePayment à notre plateforme.
- Vous redirigez vos clients via le redirectUrl , où ils cliquent sur le bouton "Switch to app" (pour les requêtes CreateHostedCheckout) ou sur merchantAction.showFormData.paymentProduct350.appSwitchLink (pour les requêtes CreatePayment).
- L'appareil mobile ouvre l'application Swish. Vos clients confirment le paiement dans l'application.
- Nous recevons le résultat de la transaction.
- L'appareil mobile affiche le résultat de la transaction dans l'application Swish.
- L'application redirige vos clients vers votre returnUrl.
- Vous demandez le résultat de la transaction à notre plateforme via GetPaymentDetails ou GetHostedCheckout, ou vous recevez le résultat via des webhooks.
-
Si la transaction a réussi, vous pouvez livrer les biens ou le service.
Test
Consultez nos Cas de test pour des données de test et des instructions détaillées.
- Assurez-vous d'utiliser le bon endpoint et de renseigner l'URL de production dès que vous avez terminé vos tests.
- Les données dans notre chapitre Cas de test fonctionnent UNIQUEMENT pour les demandes de paiement dans notre environnement de test. Utiliser ces données dans notre environnement de production entraînera des résultats de test indésirables.