Introduction
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.
À qui s’adresse ce document ?
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
Comprendre les paiements Sofort avec Worldline Sips
Principes généraux
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.
Règles d’acceptation
Fonctionnalités disponibles
| 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 |
Confirmation de virement
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.
Rapprochements bancaires
Rapprochement avec un compte en banque Sofort
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.
Rapprochements sans compte en banque Sofort
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.
Ouvrir votre compte Sofort
Prérequis
Afin d'utiliser le moyen de paiement Sofortüberweisung sur Worldline Sips, vous devez créer un projet Sofort de type « Gateway ».
Création d'un projet Sofort « 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.
Identifiants du projet Sofort
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.
Effectuer un paiement 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 :
.png)
- Compte commerçant hors banque Sofort :
.png)
Effectuer un paiement Sofort avec Sips Paypage
La cinématique de paiement pour Sips Paypage est décrite ci-dessous :
Paramétrer la requête de paiement
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. |
Analyser la réponse
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 =
SOFORTUBERWEISUNGpaymentMeanType =
CREDIT_TRANSFERresponseCode =
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.
Effectuer un paiement Sofort avec Sips Office
Le processus de paiement pour Sips Office est décrit ci-dessous :
Initialiser un virement (creditTransfertInitialize)
L’initialisation d’un virement Sofort est effectuée en appelant la méthode creditTransfertInitialize.
Requête d’initialisation d’un virement
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. |
Réponse d’initialisation d’un virement
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 =
00authorisationId = (voir le
Dictionnaire des données).messageVersion = version du
message récupérée en réponse à l’initialisation du
paiement.paymentMeanBrand =
SOFORTUBERWEISUNGresponseCode =
00redirectionData = 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.
Rediriger le client vers le site Web de sa banque en ligne
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 |
Finaliser un virement (CreditTransferFinalizeAndOrder)
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.
Requête de finalisation du virement
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). |
Réponse de finalisation du virement
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 =
00authorisationId = (voir le
Dictionnaire des données).paymentMeanBrand =
SOFORTUBERWEISUNGresponseCode =
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.
Gérer vos transactions Sofort
Opérations de caisse disponibles
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é :
- 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.
Remboursement (Comptes en banque Sofort uniquement)
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.
Consulter vos transactions Sofort
Journaux
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 |
Sips Office Extranet
Vous pouvez consulter vos transactions Sofortüberweisung et effectuer différentes opérations de gestion de caisse grâce à Sips Office Extranet.
Extranet Sofort
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.
