WL SIPS DOCS

Release 24.3

aller directement au contenu

Rechercher par mots clés

Sofort

Pour rechercher dans la page utiliser Ctrl+F sur votre clavier

Worldline Sips est une solution de paiement de commerce électronique multicanale sécurisée conforme à la norme PCI DSS. Elle vous permet d’accepter et de gérer des transactions de paiement en prenant en compte les règles métier liées à votre activité (paiement à la livraison, paiement différé, paiement récurrent, paiement en plusieurs fois…).

L’objectif du présent document est d’expliquer l'intégration du moyen de paiement Sofort dans Worldline Sips.

Ce document a pour objectif de vous aider à implémenter le moyen de paiement Sofort sur votre site de commerce électronique.

Il comprend :

  • des informations fonctionnelles à votre attention ;
  • des instructions d'implémentation à destination de votre équipe technique.

Pour avoir une vue d’ensemble de la solution Worldline Sips, nous vous conseillons de consulter les documents suivants :

  • Présentation fonctionnelle
  • Guide de configuration des fonctionnalités

Sofort Banking est un moyen de paiement par virement très populaire en Allemagne, mais également disponible pour les clients titulaires d'un compte bancaire dans les pays suivants : Autriche, Suisse, Pologne, Italie, Espagne, Belgique, Pays-Bas.

Pour payer avec ce moyen de paiement, le client va s’authentifier sur sa banque en ligne, puis valider son paiement.

Canaux de paiement
Internet V Canal de paiement par défaut
MOTO X
Télécopie X
SVI X
Typologies de paiement
Paiement immédiat V Méthode par défaut
Paiement en fin de journée X
Paiement différé X
Paiement à l'expédition X
Paiement en plusieurs fois X
Paiement par abonnement X
Paiement par fichier X
Paiement OneClick X
Gestion des devises
Acceptation multidevise V Banque Sofort : EUR uniquement

Autre banque : EUR, GBP, CHF

Règlement en devise V Banque Sofort : EUR uniquement

Autre banque : EUR, GBP, CHF

La réponse fournie par Sofort lors de l’acte de paiement n’est que temporaire, elle peut varier les jours qui suivent.

Si votre compte commerçant est à la banque Sofort, la réponse est confirmée entre 1 et 10 jours plus tard. C’est la raison pour laquelle la transaction passe de l’état TO_CONFIRM_CAPTURE à l’état CAPTURED si Sofort confirme définitivement le paiement ou à l'état CAPTURE_REFUSED, si Sofort refuse définitivement le paiement. Vous serez notifié par la réponse automatique du résultat final du paiement.

Si votre compte commerçant n’est pas à la banque Sofort, la réponse n’est jamais confirmée. Vous devez vous adresser directement à votre banque pour connaître le résultat final du paiement.

Une transaction au statut CAPTURED est considérée comme rapprochée, et Sofort garantit que les fonds aient bien été transférés. Elle apparaît ensuite dans les journaux de rapprochement des transactions Worldline Sips, si vous possédez ces journaux.

Une transaction au statut CAPTURED est considérée comme rapprochée. Toutefois, cela ne garantit pas que les fonds aient bien été transférés sur votre compte.

Afin d'utiliser le moyen de paiement Sofortüberweisung sur Worldline Sips, vous devez créer un projet Sofort de type « Gateway ».

Vous devez d'abord créer un compte client Sofort puis créer un « Projet Gateway » :



Les champs optionnels doivent être laissés vides. Les seuls champs techniques à remplir sont les suivants :

  • retransmission automatique ;
  • mettre le délai d'attente sur 600 secondes.


Vous devez envoyer à Worldline vos clés de configuration afin que Worldline Sips puisse réaliser les paiements et les virements sur votre projet (exemple masqué).



Vous pouvez trouver cette clé dans le tableau « clé API » dans l'extranet Sofort.



Worldline Sips vous offre deux solutions pour intégrer le moyen de paiement Sofort :

  • Sips Paypage qui assure l’interface de paiement directement avec le client via son navigateur Web.
  • Sips Office qui vous laisse la possibilité d’afficher vous-même vos pages de paiement et qui fonctionne par un dialogue de serveur à serveur.

Les diagrammes ci-dessous expliquent les différents états par lesquels peuvent passer les transactions selon le mode de capture choisi :

  • Compte commerçant à la banque Sofort :

Description des status possibles pour une transaction Sofort

En mode annulation (captureMode = AUTHOR_CAPTURE), si la transaction est en attente de confirmation d'autorisation, elle passe en statut TO_CONFIRM_CAPTURE. Si la transaction est refusée (responseCode différent de 00), elle passe en statut REFUSED.
  • Compte commerçant hors banque Sofort :

Description des status possibles pour une transaction Sofort

En mode annulation (captureMode = AUTHOR_CAPTURE), si la transaction est acceptée, la transaction passe en statut CAPTURED.

La cinématique de paiement pour Sips Paypage est décrite ci-dessous :


Étapes d'un paiement Masterpass via Paypage

1) Le client procède au paiement. 2) Il est redirigé vers la page de sélection du moyen de paiement hébergée chez Worldline Sips, il sélectionne Sofort. 3) Il est redirigé vers la page Sofort où il sélectionne la banque. 4) Il est ensuite redirigé vers la banque en ligne où il s'authentifie 5) Il est redirigé sur une page Worldline Sips. 6) S'il clique sur le bouton de retour à la boutique, il est redirigé vers votre site Web ce qui délenche l'envoi de la réponse manuelle. 7) Worldline Sips envoie une réponse automatique.

Les champs suivants ont un comportement particulier :

Nom du champ Remarques / règles
captureMode La valeur envoyée dans la requête est ignorée.
Le mode de capture est remplacé par AUTHOR_CAPTURE.
captureDay La valeur envoyée dans la requête est ignorée.
Le délai de capture est forcé à 0.
paymentPattern La valeur envoyée dans la requête est ignorée.
Le type de paiement est forcé à ONE SHOT.
customerLanguage
Permet de choisir la langue utilisée sur les pages Worldline Sips et Sofort.

Le tableau suivant récapitule les différents cas de réponse à traiter :

État Champs de la réponse Action à réaliser
Paiement accepté acquirerResponseCode = 00
authorisationId = (voir le Dictionnaire des données).
paymentMeanBrand = SOFORTUBERWEISUNG
paymentMeanType = CREDIT_TRANSFER
responseCode = 00
Vous pouvez livrer la commande.
Refus acquéreur acquirerResponseCode = (voir le Dictionnaire des données).
responseCode = 05
L’autorisation est refusée pour un motif non lié à la fraude.
Si vous n’avez pas opté pour l’option « nouvelle tentative de paiement » (pour plus de détails veuillez consulter le Guide de configuration des fonctionnalités), vous pouvez proposer à votre client de payer avec un autre moyen de paiement en générant une nouvelle requête.
Refus nombre max essais atteint responseCode = 75 Le client a fait plusieurs tentatives qui ont toutes échoué.
Refus suite problème technique acquirerResponseCode = 90-98
responseCode = 90, 99
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement.

Pour connaître l'intégralité des codes réponses (responseCode) et codes réponses acquéreur (acquirerResponseCode), veuillez vous référer au Dictionnaire des données.

Le processus de paiement pour Sips Office est décrit ci-dessous :


Étapes d'un paiement Sofort via Office

1) Le client procède au paiement directement sur votre site Web. 2) Vous initialisez le paiement auprès de Worldline Sips (creditTransfertInitialize). 3) Vous redirigez le client vers les pages d'identification et de paiement Sofort (redirectionUrl). 4) Sofort redirige ensuite le client vers sa banque en ligne pour s'authentifier et faire le paiement 5) Vous finalisez le paiement auprès de Worldline Sips (creditTransfertFinalize). 6) Vous affichez le résultat du paiement à votre client.

L’initialisation d’un virement Sofort est effectuée en appelant la méthode creditTransfertInitialize.

Vous devez valoriser les champs spécifiques suivants dans la requête d'initialisation pour un virement Sofortüberweisung :

Nom du champ Remarques / règles
captureMode La valeur envoyée dans la requête est ignorée.
Le mode de capture est forcé à AUTHOR_CAPTURE.
captureDay La valeur envoyée dans la requête est ignorée.
Le délai de capture est forcé à 0.
paymentPattern La valeur envoyée dans la requête est ignorée.
Le type de paiement est forcé à ONE_SHOT.
customerLanguage
Permet de choisir la langue utilisée sur les pages Worldline Sips et Sofort.
paymentMeanBrand
Doit être valorisé avec SOFORTÜBERWEISUNG.

Le tableau suivant récapitule les différents cas de réponse à traiter :

État Champs de la réponse Action à réaliser
Initialisation de virement acceptée acquirerResponseCode = 00
authorisationId = (voir le Dictionnaire des données).
messageVersion = version du message récupérée en réponse à l’initialisation du paiement.
paymentMeanBrand = SOFORTUBERWEISUNG
responseCode = 00
redirectionData = données de redirection récupérées en réponse à l’initialisation du paiement.
redirectionUrl = URL intent
Redirigez le client vers redirectionUrl.
Initialisation de virement rejetée
responseCode <> 00
Consultez le champ errorFieldName, puis corrigez la requête.
En cas d’erreur persistante, contactez l'assistance technique.
Refus acquéreur acquirerResponseCode = (voir le Dictionnaire des données).
responseCode = 05
L’autorisation est refusée pour un motif non lié à la fraude, vous pouvez proposer à votre client de payer avec un autre moyen de paiement en générant une nouvelle requête.
Refus suite problème technique acquirerResponseCode = 90-98
responseCode = 90, 99
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement.

Pour connaître l'intégralité des codes réponses (responseCode) et codes réponses acquéreur (acquirerResponseCode), veuillez vous référer au Dictionnaire des données.

Le client doit être redirigé vers l’URL redirectionUrl fournie en réponse de la méthode creditTransferInitialize. Cette redirection consiste à effectuer un appel POST sur l’URL redirectionUrl obtenue dans la réponse à l’initialisation de paiement. Les paramètres POST à transmettre sont redirectionData et messageVersion obtenus également dans la réponse à l’initialisation de paiement.

À la fin de la cinématique de paiement, le client est redirigé sur l’URL fournie dans la requête d’initialisation, merchantReturnUrl. Les champs suivants sont transmis en POST et doivent être récupérés pour finaliser le paiement :

Nom du champ Remarques / règles
responseCode Code réponse du processus de redirection
redirectionData Données de redirection récupérées en réponse à l’initialisation du paiement.
messageVersion Version du message récupérée en réponse à l’initialisation du paiement.
amount Montant de la transaction en centimes
merchantId Identifiant de la boutique
transactionReference Référence de la transaction
transactionId Identifiant de la transaction
transactionDate Date de la transaction

La méthode utilisée pour finaliser un virement est CreditTransferFinalizeAndOrder.

Cette demande doit être envoyée pour que chaque transaction bénéficie d'un statut, car il n'y a pas de notification automatique. La demande peut être effectuée lorsque l'utilisateur revient du site Web de sa banque ou, s’il ne revient pas, dans un délai de 30 minutes après la redirection.

Vous devez valoriser les champs spécifiques suivants dans la requête de finalisation pour un virement Sofortüberweisung :

Nom du champ Remarques / règles
redirectionData Données de redirection récupérées au retour du client vers votre site Web (voir Rediriger le client vers le site de sa banque en ligne).
messageVersion Version du message récupérée au retour du client vers votre site Web (voir Rediriger le client vers le site de sa banque en ligne).

Le tableau suivant récapitule les différents cas de réponse à traiter :

État Champs de la réponse Action à réaliser
Paiement accepté acquirerResponseCode = 00
authorisationId = (voir le Dictionnaire des données).
paymentMeanBrand = SOFORTUBERWEISUNG
responseCode = 00
Vous pouvez livrer la commande.
Refus acquéreur acquirerResponseCode = (voir le Dictionnaire des données).
responseCode = 05
L’autorisation est refusée pour un motif non lié à la fraude, vous pouvez proposer à votre client de payer avec un autre moyen de paiement en générant une nouvelle requête.
Refus suite problème technique acquirerResponseCode = 90-98
responseCode = 90, 99
Problème technique temporaire lors du traitement de la transaction. Proposez à votre client de refaire un paiement ultérieurement.

Pour connaître l'intégralité des codes réponses (responseCode) et codes réponses acquéreur (acquirerResponseCode), veuillez vous référer au Dictionnaire des données.

Les opérations suivantes sont disponibles sur les transactions Sofort :

Gestion de caisse
Annulation X Annulation impossible car un transfert ne peut être annulé.
Validation X
Remboursement V Remboursement possible sur le montant total ou partiel de la transaction, uniquement pour les comptes commerçants de la banque Sofort.
Duplication X
Crédit X

Le cycle de vie diffère en fonction de votre banque. Deux cas sont possibles :

  • Compte commerçant à la banque Sofort :

Le diagramme ci-dessous vous permet de savoir quelle opération de gestion de caisse est disponible lorsqu'une transaction est dans un état donné :


Disponibilité des opérations de caisse

En cas de refus, la transaction passe du statut TO_CONFIRM_CAPTURE à CAPTURE_REFUSED, en cas d'acceptation, le statut devient CAPTURED. Losrque le statut est CAPTURED on peut faire un remboursment total est partiel. En cas de remboursement partiel le statut reste CAPTURED et en cas de remboursement total le statut devient CREDITED.
  • Compte commerçant hors banque Sofort :

Aucune opération de caisse n’est possible si votre compte commerçant n’est pas à la banque Sofort.

Une transaction Sofortüberweisung peut être remboursée seulement si votre compte en banque est enregistré à la banque Sofort. Tous les autres comptes ne sont pas en mesure de rembourser les transactions.

Le remboursement est la seule opération de gestion de caisse disponible. Les remboursements partiels et complets sont tous deux possibles.

Par défaut, une transaction Sofortüberweisung peut seulement être remboursée sous 3 mois. Passé ce délai, Sofort supprime les identifiants de l'émetteur de son système (en raison des lois relatives à la protection de la vie privée en Allemagne). Veuillez contacter le service clientèle de Sofort si ce délai doit être étendu.

Une transaction Sofortüberweisung peut seulement être remboursée si la devise est l'EURO.

Pour utiliser la fonctionnalité remboursement, vous devez signer une lettre de procuration afin d'autoriser Worldline Sips à réaliser des virements créditeurs à partir de votre compte Sofort.

Les journaux mis à disposition par Worldline Sips vous permettent d’avoir une vision exhaustive et consolidée de vos transactions, opérations de caisse, situation comptable et impayés. Vous pouvez utiliser ces informations pour enrichir votre système d’information.

La disponibilité des transactions Sofort pour chaque type de journal est récapitulée dans le tableau ci-dessous :

Disponibilité des journaux
Journal des transactions V
Journal des opérations V
Journal de rapprochement des transactions V
Journal de rapprochement des impayés X
Note: pour les transactions Sofort, le champ paymentMeanBrand est renseigné avec la valeur SOFORTUBERWEISUNG.

Vous pouvez consulter vos transactions Sofortüberweisung et effectuer différentes opérations de gestion de caisse grâce à Sips Office Extranet.



L'extranet Sofort peut seulement être utilisé à des fins de consultation. Le champ ID Sofort correspond au champ authorisationId pour les transactions Worldline Sips et le champ motif du paiement correspond au champ transactionReference sur Worldline Sips, réduit à 27 caractères. Par conséquent, vous pouvez facilement trouver vos transactions Worldline Sips dans l'extranet Sofort.

Attention: toutes les opérations de gestion de caisse sur une transaction Sofortüberweisung doivent être effectuées en utilisant les outils de Worldline Sips. La réalisation d'une action de gestion de caisse à partir d'un compte commerçant Sofortüberweisung peut mener à une incohérence du statut de la transaction entre Worldline Sips et Sofort.

Ce site utilise des traceurs pour améliorer votre expérience de navigation, effectuer des analyses et des recherches sur votre utilisation du site web de documentation WL Sips.
En fermant ce bandeau vous refusez notre utilisation des traceurs sur votre appareil.

Paramètres