Introduction
Sogenactif 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 échelonné…).
L’objectif du présent document est d’expliquer l'intégration du moyen de paiement Sofort dans Sogenactif.
À 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 Sogenactif, nous vous conseillons de consulter les documents suivants :
- Présentation fonctionnelle
- Configuration des fonctionnalités
Contacter l'assistance
Pour toute question technique ou demande d'assistance, nos services sont disponibles du lundi au vendredi, hors jours fériés, de 9 h à 19 h :
- par téléphone au : +33 (0) 825 090 095 (0,15 € TTC/min + prix d’un appel local – Tarif au 12/09/2022)
- par e-mail : supportsogenactif@worldline.com
Pour faciliter le traitement de vos demandes, veuillez communiquer votre identifiant de commerçant : merchantId (numéro à 15 chiffres).
Comprendre les paiements Sofort avec Sogenactif
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 échelonné | X | |
| Paiement récurrent | X | |
| Paiement par fichier | X | |
| Paiement One Clic | 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 Sogenactif, 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 Sogenactif, 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 à SG vos clés de configuration afin que Sogenactif 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
Sogenactif vous offre deux solutions pour intégrer le moyen de paiement Sofort :
- Sogenactif Paypage qui assure l’interface de paiement directement avec le client via son navigateur Web.
- Sogenactif Office Serveur 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 Sogenactif Paypage
La cinématique de paiement pour Sogenactif 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
Sogenactif 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 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 Sogenactif Office Serveur
Le processus de paiement pour Sogenactif Office Serveur 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
Sogenactif 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 | |
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 Sogenactif à réaliser des virements créditeurs à partir de votre compte Sofort.
Consulter vos transactions Sofort
Journaux
Les journaux mis à disposition par Sogenactif 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 bancaire | V |
| Journal de rapprochement des impayés | X |
Sogenactif Gestion
Vous pouvez consulter vos transactions Sofortüberweisung et effectuer différentes opérations de gestion de caisse grâce à Sogenactif Gestion.
Extranet Sofort
L'extranet Sofort peut seulement être utilisé à des fins de consultation. Le champ ID Sofort correspond au champ authorisationId pour les transactions Sogenactif et le champ motif du paiement correspond au champ transactionReference sur Sogenactif, réduit à 27 caractères. Par conséquent, vous pouvez facilement trouver vos transactions Sogenactif dans l'extranet Sofort.
