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 iDEAL dans Sogenactif.
À qui s’adresse ce document ?
Ce document a pour objectif de vous aider à implémenter le moyen de paiement iDEAL 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 iDEAL avec Sogenactif
Principes généraux
iDEAL est un moyen de paiement largement utilisé aux Pays-Bas.
Ce moyen de paiement permet aux clients d’effectuer des achats par virement direct en ligne depuis leur compte bancaire.
Afin de régler sa commande en ligne, via iDEAL, le client doit d’abord sélectionner sa banque dans un menu déroulant. Une fois redirigé vers l'interface de sa banque, il s'authentifie puis confirme le virement bancaire.
De plus, le client n’a pas besoin de s’inscrire à ce service. Il peut directement utiliser iDEAL s’il est client de l’une des banques participantes.
Règles d’acceptation
Fonctionnalités disponibles
| Canaux de paiement | ||
|---|---|---|
| Internet | V | Canal de paiement par défaut |
| MAIL_ORDER, TELEPHONE_ORDER | X | |
| Télécopie | X | |
| SVI | X | |
| Typologies de paiement | ||
|---|---|---|
| Paiement immédiat | V | |
| 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 | X | Euro uniquement |
| Règlement en devise | X | Euro uniquement |
Confirmation de virement
Dans certains cas d’usage, la banque ne décide pas immédiatement de la réponse à donner au paiement et retourne un code 60, signifiant que la transaction est en cours de validation. Par conséquent, lorsque votre client retourne sur votre site Web, vous ne savez pas si vous pouvez ou non livrer la marchandise. Dès réception de la réponse de la banque, Sogenactif vous transmet une réponse automatique avec le résultat final du paiement, vous savez alors si le paiement iDEAL a été autorisé ou refusé.
En définitive, pour les cas d’usage « code 60 », vous recevez 2 messages de réponses automatiques :
- 1 message avec le code 60 ;
- 1 message avec le code réponse définitif (code réponse 00 si le paiement est accepté, autre code si le paiement est refusé).
Ouvrir votre contrat d'acceptation iDEAL
Afin de proposer le moyen de paiement iDeal sur votre site Web, vous devez souscrire un contrat d'acceptation auprès de Worldline Sweden. Vous nous transmettez par la suite le numéro de contrat afin de l’enregistrer dans notre système d’information.
Effectuer un paiement iDEAL
Vous pouvez proposer le moyen de paiement iDEAL au travers de l’interface Sogenactif Paypage qui assure le paiement directement avec le client via son navigateur Web.
Pour les paiements iDEAL, il n’est pas possible de différer la remise, vous ne pouvez pas ajuster la date de transferts des fonds (paiement immédiat).
Le diagramme ci-dessous explique les différents états par lesquels peuvent passer les transactions :
Effectuer un paiement iDEAL 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 forcé à AUTHOR_CAPTURE. |
| captureDay | La valeur envoyée dans la requête est ignorée. Le délai
de capture est forcé à 0. |
| customerLanguage | Permet de choisir la langue utilisée sur les pages Sogenactif et iDEAL. |
| paymentPattern | La valeur envoyée dans la requête est ignorée. Le type
de paiement est forcé à ONE_SHOT. |
| statementReference | La valeur envoyée apparaîtra sur votre relevé de compte. Les caractères autorisés sont [a-zA-Z0-9 /\+=.]. |
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 =
IDEALpaymentMeanType =
CREDIT_TRANSFERresponseCode =
00 |
Vous pouvez livrer la commande. |
| Transaction en attente | acquirerResponseCode = (voir
le Dictionnaire des données).responseCode =
60 |
Vous devez attendre de recevoir la seconde réponse automatique pour cette transaction afin de connaître son statut final et savoir si vous pouvez expédier la marchandise. Si vous ne recevez pas la réponse automatique, vous devrez consulter régulièrement les journaux des transactions. |
| 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 iDEAL avec Sogenactif Office Serveur
L'acceptation du moyen de paiement iDEAL n'est pas disponible au travers de la solution Sogenactif Office Serveur.
Gérer vos transactions iDEAL
Opérations de caisse disponibles
Les opérations suivantes sont disponibles sur les transactions iDEAL :
| Gestion de caisse | ||
|---|---|---|
| Annulation | X | L'opération est impossible car un virement ne peut être annulé. |
| Validation | X | |
| Remboursement | V | Remboursement possible sur
le montant total ou partiel de la transaction. |
| Duplication | X | |
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é :
Consulter vos transactions iDEAL
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 iDEAL 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 iDEAL et effectuer différentes opérations de gestion de caisse grâce à Sogenactif Gestion.
Voici le détail d'une transaction iDEAL :
