logo Sogenactif

Release 24.1

aller directement au contenu

Rechercher par mots clés

Moyens de paiement prépayés

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

  • Sogenactif

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 des moyens de paiement prépayés Cadhoc, Illicado, Spirit Of Cadeau et CadoCarte dans Sogenactif.

Ce document a pour objectif de vous aider à implémenter les moyens de paiement prépayés Cadhoc, Illicado, Spirit Of Cadeau et CadoCarte 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

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).

Sogenactif propose plusieurs moyens de paiement prépayés (CADHOC, ILLICADO, SPIRITOFCADEAU ou CADOCARTE). Le principe est le suivant :

  • Le client renseigne les données de son moyen de paiement prépayé (numéro de carte prépayée ou autre).
  • Si le moyen de paiement prépayé ne couvre pas la totalité du montant du panier, le client paie le complément avec sa carte bancaire.

Le paiement CB complémentaire suit nécessairement une cinématique 3-D Secure. Si le complément carte n’est pas accepté ou que l'authentification 3-D Secure n'est pas réussie, la totalité de la transaction est annulée, et la somme du moyen de paiement prépayé n’est pas consommée.

Note: certains moyens de paiement prépayés peuvent imposer un montant minimum et/ou maximum utilisable. Nous vous conseillons de consulter les Conditions Générales de Vente du moyen de paiement prépayé concerné afin d’en connaître les détails.
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 X
Règlement en devise X

Au cours de la cinématique de paiement, il est possible que nous ne recevions pas le retour escompté (timeout), l'état de la transaction est :

  • TO_CONFIRM_CAPTURE
  • TO_CONFIRM_CREDIT

Un traitement par fichier est exécuté quotidiennement pour mettre à jour ces transactions vers des états finaux :

  • REFUSED
  • CAPTURED
  • CREDITED

Le diagramme du paragraphe Effectuer un paiement schématise ces états ainsi que les transitions.

Le statut final apparaîtra dans vos journaux des transactions pour vous permettre de continuer le traitement de la commande.

Attention: les opérations de gestion de caisse ne sont pas disponibles pour les transactions dont l'état est TO_CONFIRM_AUTHOR ou TO_CONFIRM_CAPTURE.

Afin de proposer un des moyens de paiement prépayés sur votre site Web, vous devez souscrire un contrat d'acceptation auprès du distributeur du moyen de paiement prépayé choisi. Vous nous transmettez par la suite le numéro de contrat afin de l’enregistrer dans notre système d’information.

Afin que le complément CB soit proposé au client, le numéro de contrat Sogenactif est utilisé pour l'acceptation et l'acquisition des paiements par carte CB, Visa et Mastercard.

Sogenactif vous offre deux solutions pour intégrer les moyens de paiement prépayés Cadhoc, Illicado, Spirit Of Cadeau et CadoCarte :

  • 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.

Le seul mode de remise disponible pour une transaction effectuée avec un moyen de paiement prépayé est le mode immédiat (la remise de la transaction est réalisée au moment de l’acceptation du paiement en ligne).

Le diagramme ci-dessous explique les différents états par lesquels peuvent passer la transaction:


diagramme montrant les différents états d'une transaction

Dans le mode immédiat, la transaction passera soit à l'état Captured si elle a été acceptée (response code 00), soit à l'état Refused si elle a été refusé (response code différent de 00).

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


image montrant la cinématique d'un paiement via Paypage

1) Après avoir finalisé sa commande sur le site web commerçant, le client procède au paiement. 2) le client est redirigé vers les pages de paiement hébergées côté Sogenactif et sélectionne un des moyens de paiement prépayés. 3) Le client est redirigé vers la page du moyen de paiement prépayé. Il peut éventuellement faire un complément avec une carte CB, Visa ou Mastercard.. 4) Au retour du client vers Sogenactif, le ticket avec le résultat du paiement s'affiche. 5) Si le client clique sur le bouton de retour à la boutique, il est redirigé sur le site web commerçant ce qui délenche l'envoi de la réponse manuelle. 6) Le moteur Sogenactif envoie également une réponse automatique vers le site commerçant.

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é à IMMEDIATE.
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 celles du paiement CB complémentaire.
paymentPattern La valeur envoyée dans la requête est ignorée.
Le type de paiement est forcé à ONE_SHOT.
orderId Obligatoire
customerContact.email Obligatoire

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 = CADHOC, ILLICADO, SPIRITOFCADEAU ou CADOCARTE
paymentMeanType = VOUCHER
responseCode = 00
Vous pouvez livrer la commande.
Transaction en attente acquirerResponseCode = (voir le Dictionnaire des données).
responseCode = 60
La transaction est toujours en cours de traitement.
Vous recevrez une nouvelle réponse avec un statut définitif dans 30 minutes.
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.

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


image montrant la cinématique d'un paiement via Office

1) Après avoir finalisé sa commande sur le site web commerçant, le client procède au paiement. 2) Le commerçant initialise le paiement sur le moteur Sogenactif. 3) Le commerçant redirige le client vers la page de paiement du moyen de paiement prépayé sélectionné. 4) Une fois le paiement effectué, le client est redirigé vers le site commerçant. 5) Le commerçant finalise le paiement sur le moteur Sogenactif. 6) Le commerçant afiche le résultat du paiement sur son site.

L’initialisation d’un paiement est effectuée en appelant la méthode paymentProviderInitialize.

Les champs génériques suivants sont définis dans le cas d’une initialisation de paiement :

Nom du champ Remarques / règles
merchantReturnUrl URL de retour du commerçant
paymentMeanBrand Doit être valorisé avec CADHOC, ILLICADO, SPIRITOFCADEAU ou CADOCARTE.

Vous devez valoriser les champs spécifiques suivants dans la requête d'initialisation pour un paiement CADHOC, ILLICADO, SPIRITOFCADEAU ou CADOCARTE :

Nom du champ Remarques / règles
captureMode La valeur envoyée dans la requête est ignorée.
Le mode de capture est forcé à IMMEDIATE.
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 CB complémentaire.
paymentPattern La valeur envoyée dans la requête est ignorée.
Le type de paiement est forcé à ONE_SHOT.
orderId Obligatoire
CustomerContact.email Obligatoire

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

État Champs de la réponse Action à réaliser
Initialisation de paiement acceptée acquirerNativeResponseCode = 00
messageVersion = version du message récupérée en réponse à l’initialisation du paiement.
responseCode = 00
redirectionData = données de redirection récupérées en réponse à l’initialisation du paiement.
redirectionUrl = URL de redirection vers le site Web du moyen de paiement.
Redirigez le client vers redirectionUrl.
Initialisation de paiement 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 paymentProviderInitialize. 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.

A 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
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

Cette dernière étape vous permet d’obtenir le statut du paiement. Les paramètres obtenus lors de la redirection après la cinématique de paiement sur le site Web du moyen de paiement sont à transmettre lors de cet appel. La méthode utilisée pour finaliser un paiement est paymentProviderFinalize.

Tip: vous pouvez, en réponse à votre requête paymentProviderFinalize, obtenir un code 24 « Opération impossible ». Ce code signifie que cette requête a déjà été envoyée et traitée pour la transaction concernée. Si vous ne pouvez identifier ce traitement, nous vous invitons à utiliser la fonction GetTransactionData du service diagnostic : cette opération permet de récupérer des informations relatives à une transaction créée préalablement à l'aide de Sogenactif.

Vous devez fournir les champs spécifiques suivants dans la requête de finalisation pour un paiement CADHOC, ILLICADO, SPIRITOFCADEAU ou CADOCARTE.

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 Web du moyen de paiement).
messageVersion Version du message récupérée au retour du client vers votre site Web (voir Rediriger le client vers le site Web du moyen de paiement).

The following table summarises the different response cases to be processed:

État Champs de la réponse Action à réaliser
Paiement accepté acquirerResponseCode = 00
authorisationId = (voir le Dictionnaire des données).
acquirerResponseMessage = informations sur les montants payés par chacun des moyens de paiement.
Format = champ1:champ2:[...]champ7
champ1 = SPLIT
champ2 = nom du moyen de paiement prépayé
champ3 = référence partenaire du paiement prépayé
champ4 = montant payé avec le moyen de paiement prépayé
champ5 = moyen de paiement complémentaire
champ6 = PAN masqué
champ7 = montant payé avec le moyen de paiement complémentaire
paymentMeanBrand = CADHOC, ILLICADO, SPIRITOFCADEAU ou CADOCARTE
responseCode = 00
transactionStatus = (voir le Dictionnaire des données).
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 :

Gestion de caisse
Annulation X
Validation X
Remboursement V En cas de remboursement, c'est la partie CB qui est remboursée en priorité.
Pour les moyens de paiement prépayés remboursables, il est précisé dans l'email de confirmation de transaction envoyé aux clients de conserver leurs cartes cadeaux qui seront recréditées en cas de remboursement.
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é :


diagramme montrant les différents états d'une transaction

La transaction passera de l'état Captured à l'état Credited une fois qu'elle sera remboursée complètement.

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 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 Sauf CADHOC.
Journal de rapprochement des impayés V Sauf CADHOC.
Note: le champ paymentMeanBrand est renseigné en fonction du moyen de paiement utilisé pour la transaction, soit ici : CADHOC, ILLICADO, SPIRITOFCADEAU ou CADOCARTE.
Note:

Le champ acquirerReconciliationDetail est présenté sur les journaux de rapprochement des moyens de paiement prépayé.

Cette donnée est générée au moment de la réconciliation à partir des informations fournies par l'acquéreur pour des moyens de paiement Prépayés.

La valeur de cette donnée est la concaténation de sept champs séparés par le caractère ":" qui contiennent les informations détaillées sur les montants payés par chacun des moyens de paiement.

Elle est structurée de la manière suivante :
  • champ 1 = SPLIT
  • champ 2 = nom du moyen de paiement prépayé
  • Champ 3 = PAN masqué du moyen de paiement prépayé
  • champ 4 = montant payé avec le moyen de paiement prépayé (avec 2 décimales)
  • champ 5 = moyen de paiement complémentaire
  • Champ 6 = PAN masqué du moyen de paiement complémentaire
  • champ 7 = montant payé avec le moyen de paiement complémentaire (avec 2 décimales)

Vous pouvez consulter vos transactions et effectuer différentes opérations de gestion de caisse grâce à Sogenactif Gestion.

Voici le détail d'une transaction



Retourner en haut de page Besoin d'aide ?

Besoin d'aide ?

Fermer

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 Sogenactif.
En fermant ce bandeau vous refusez notre utilisation des traceurs sur votre appareil.

Paramètres