logo Sogenactif

Release 22.4

aller directement au contenu

Rechercher par mots clés

office

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

Les pages de paiements sont hébergées chez le commerçants. Cela permet une grande liberté de personnalisation. Ce connecteur permet également d’effectuer des opérations de gestion de caisse en mode machine to machine.

Méthodes

  • acceptChallenge

    Cette fonction vous permet d’accepter le risque de fraude sur des transactions ayant un score de fraude orange. Une fois la transaction acceptée, elle reprend son cycle de vie normal.

  • addCard

    Cette opération permet d’ajouter une carte à un wallet. Ce dernier est créé en même temps que l’ajout de la carte, s’il n’existe pas.

    Les informations sensibles (numéro de carte) peuvent être gérées via le champ panType, chiffrement par l’utilisation du mode CSE (voir la documentation concernée).

    Si la carte est déjà enregistrée dans le wallet, un code de réponse 94 est retourné.

    Si la création a réussi, un code de réponse 00 est retourné ainsi que de nombreuses informations sur le compte et la carte associée

    • identifiant wallet
    • date de création
    • identifiant externe du moyen de paiement créé pour le wallet
    • numéro de carte partiellement masqué (seuls les 4 premiers chiffres et 2 derniers sont affichés).
  • addDirectDebit

    Cette opération permet d’ajouter un mandat au wallet. Si le mandat est déjà enregistré dans le wallet, un code de réponse 94 est retourné.

    Si la création a réussi, un code de réponse 00 est retourné, ainsi que de nombreuses informations sur le compte et le mandat associé

    • date de création
    • identifiant externe du moyen de paiement créé pour le wallet
    • numéro international de compte bancaire (IBAN) partiellement masqué (seuls les 4 premiers chiffres et 2 derniers sont affichés).
  • addToFraudList

    Cette opération permet d’ajouter un numéro de carte, de token ou de transaction (via le couple transactionIid/transactionDate ou transactionReference) à différents types de liste fraude.

  • cancel

    Cette fonction permet d’annuler une transaction avant l’envoi en banque ou de modifier son montant. Une opération d’annulation ne peut pas être annulée et on ne peut pas annuler un montant supérieur au montant d’origine de la transaction.

  • cardCheckEnrollment

    Cette opération permet d’initialiser un paiement par carte avec processus 3-D Secure.

    Sauf mention contraire, toute référence à 3-D Secure dans le présent document inclut Visa (Verified by Visa), MasterCard (SecureCode) et American Express (SafeKey).

    Cette requête initialise une transaction sur la plateforme “Sogenactif et contrôle l’inscription de la carte. Si la carte est inscrite à 3-D Secure, vous recevez comme réponse une URL sécurisée (redirectionUrl) vers laquelle le client doit être redirigé pour poursuivre son authentification. Cette redirection doit être réalisée par le biais d’un formulaire POST, voir la partie “Formulaire POST vers l’ACS”. Dans le cas contraire, vous avez la possibilité de poursuivre le paiement sans effectuer de redirection en appelant directement la méthode cardValidateAuthenticationAndOrder.” Les informations sensibles (numéro de carte, cryptogramme visuel) peuvent être gérées selon trois possibilités, via le champ panType

    • chiffrement par l’utilisation du mode CSE ;
    • tokenisation du numéro de carte ;
    • numéro de carte en clair (forte contrainte PCI).
  • cardOrder

    Cette fonction vous permet d’effectuer un paiement carte avec les informations bancaires d’un client.

    Les informations sensibles (numéro de carte, cryptogramme visuel) peuvent être gérées selon trois possibilités, via le champ panType :

    • chiffrement par l’utilisation du mode CSE (voir la documentation concernée) ;
    • tokenisation du numéro de carte ;
    • numéro de carte en clair (forte contrainte PCI).
  • cardValidateAuthentication

    Requêtes de validation d’authentification 3-D Secure :

    Sauf mention contraire, toute référence à 3-D Secure dans le présent document inclut Visa (Verified by Visa), MasterCard (SecureCode) et American Express (SafeKey).

    Cette requête est obligatoire pour vérifier l’ensemble de l’authentification 3-D Secure (avec un message PARes). Elle doit être effectuée une fois que vous avez reçu le formulaire POST de l’ACS (Access Control Server) (voir “Envoi du formulaire POST à l’ACS”).

  • cardValidateAuthenticationAndOrder

    Cette opération permet de finaliser un ordre de paiement avec un processus 3-D Secure.

    Sauf mention contraire, toute référence à 3-D Secure dans le présent document inclut Visa (Verified by Visa), MasterCard (SecureCode) et American Express (SafeKey).

    Cette requête est obligatoire pour l’exécution d’un ordre de paiement dans un contexte 3-D Secure (message PARes). Elle doit être effectuée une fois que vous avez reçu le formulaire POST de l’ACS (Access Control Server) (voir « Envoi du formulaire POST à l’ACS »).

  • creditHolder

    Cette fonction vous permet de créditer le compte d’un client sans transaction d’origine référencée. Il est donc nécessaire de détenir les informations du moyen de paiement de votre client ou le token associé.

  • creditTransferFinalizeAndOrder

    Cette opération est actuellement disponible pour les moyens de paiement iDEAL et Sofortüberweisung.

    Cette requête est obligatoire pour connaître le résultat d’un virement bancaire. Elle doit être appelée une fois que vous avez reçu le formulaire POST du service de virement bancaire via merchantReturnUrl (voir requête creditTransferInitialize).

  • creditTransferInitialize

    Cette opération est actuellement disponible pour les moyens de paiement iDEAL et Sofortüberweisung.

    Cette requête initialise une session pour un virement bancaire. Si l’étape d’initialisation a réussi, vous recevez en retour une URL sécurisée (redirectionUrl) vers laquelle le client doit être redirigé pour poursuivre le virement. Cette redirection doit être réalisée par le biais d’un formulaire POST, voir la partie “Formulaire POST vers des fournisseurs externes”.

    Dans la requête, vous devez également indiquer l’URL (merchantReturnUrl) vers laquelle le client sera redirigé à la fin du virement bancaire externe. Vous devez ensuite appeler le service creditTransferFinalizeAndOrder afin de finaliser la transaction.

  • creditTransferInquire

    Cette opération permet de récupérer la liste des banques émettrices disponibles. Actuellement, ce service n’est disponible que pour le moyen de paiement iDEAL.

    Cette requête permet d’obtenir une liste des banques émettrices. Si la requête a réussi, vous recevez en retour une liste de banques avec leur nom et leur code. Ces informations doivent être utilisées pour l’étape d’initialisation (creditTransferInitialize).

  • deletePaymentMean

    Cette fonction vous permet de supprimer définitivement l’un des moyens de paiement de son wallet.

    Si le compte ou la carte n’existe pas, un code de réponse 01 est retourné. Si la suppression a fonctionné, le code de réponse 00 est retourné avec la date de suppression.

  • directDebitOrder

    Cette fonction vous permet, si vous possédez les informations bancaires d’un client, d’effectuer des paiements de type prélèvement (ex : SDD).

  • duplicate

    Cette fonction permet de créer une nouvelle transaction à partir des données d’une transaction précédente. À titre d’exemple, si une transaction n’a - par erreur ou omission - pu être validée dans le délai de capture que vous avez renseigné, elle a expiré et ne sera donc pas envoyée en remise en paiement. Vous pouvez alors rattraper cette transaction en la dupliquant.

  • finalizeMandate

    Cette opération permet de finaliser le processus de signature de mandat et de connnaître le résultat. Elle doit être appelée après que vous ayez reçu le formulaire POST sur l’url merchantReturnUrl (voir les paramètres de la requête initializeMandate).

  • getCardData

    Cette opération permet de consulter les informations associées à un numéro ou IIN de carte.

    Si le numéro ou l’IIN de la carte n’existe pas, un code de réponse 05 est retourné. Si la requête a réussi, le code de réponse 00 est retourné, ainsi que les informations relatives à la carte.

  • getFraudData

    Cette opéraiton permet de récupérer des informations relatives au contrôle anti-fraude d’une transaction créée préalablement à l’aide de “Sogenactif et stockée dans la base de données Sogenactif.”

  • getMandateData

    Cette opération permet d’obtenir des informations concernant un mandat existant. La réponse contient des informations propres au mandat telles que le statut, l’IBAN, etc… mais aussi la liste des transactions « SEPA direct debit » associées aux mandats (s’il y en a).

  • getPaymentMeanData

    Cette fonction permet de consulter un wallet et les informations de ses moyens de paiement.

    Si le compte ou le moyen de paiement n’existe pas, un code de réponse 01 est retourné. Si la requête a réussi, le code de réponse 00 est retourné, ainsi que les informations relatives au moyen de paiement.

  • getPdfMandate

    Cette fonction permet de récupérer le PDF d’un mandat existant. Le PDF est sérialisé en Base64. La chaîne de caractères doit être décodée et convertie en fichier PDF pour permettre la lecture ou le téléchargement.

  • getTransactionData

    Cette opération permet de récupérer des informations relatives à une transaction créée préalablement à l’aide de Sogenactif et stockée dans la base de données Sogenactif.

  • getVelocityData

    Cette opération permet de contrôler l’activité d’un champ de données spécifique au cours d’une période déterminée.

  • getWalletData

    Cette opération permet de consulter un wallet et les moyens de paiement associés.

    Si le compte n’existe pas, un code de réponse 01 est retourné. Si la requête a réussi, le code de réponse 00 est retourné, ainsi que les informations relatives aux moyens de paiement.

  • hostedFieldsInitialize

    Initialise une session Hosted Fields.

  • initializeMandate

    Cette opération permet d’initialiser un processus de signature de mandat. Si l’étape d’initialisation réussit, vous recevez en réponse une URL sécurisée (redirectionUrl) vers laquelle le client doit être redirigé pour continuer le processus de signature. La redirection doit être faite via un formulaire POST, voir la partie “Formulaire POST vers des fournisseurs externes”.

    Parmi les paramètres de la requête, vous devez également renseigner l’URL (merchantReturnUrl) vers laquelle le client sera redirigé à la fin du processus de signature du mandat. Vous devez ensuite appeler le service finalizeMandate pour obtenir le résultat du processus de signature.

  • paymentProviderFinalize

    Cette opération permet de finaliser un paiement pour les wallets externes.

    Une telle requête est obligatoire pour connaître le résultat d’un ordre de paiement effectué par le biais d’un wallet externe. Elle doit être appelée une fois que vous avez reçu le formulaire POST du wallet externe via la merchantReturnUrl (voir requête paymentProviderInitialize).

  • paymentProviderGetContext

    Cette requête est facultative et vous permet de connaître l’identité et l’adresse de livraison du payeur pour les afficher avant la confirmation de la transaction lors d’une transaction PayPal.

  • paymentProviderInitialize

    Cette opération permet d’initialiser un paiement pour les wallets externes.

    Une telle requête initie une session pour le passage d’ordre de paiement par wallet externe. S’il s’agit d’une transaction non initiée sur mobile et que l’étape d’initialisation a réussi, vous recevez en réponse une URL sécurisée (redirectionUrl) vers laquelle le client doit être redirigé pour poursuivre la procédure de paiement. Cette redirection doit être réalisée par le biais d’un formulaire POST, voir la partie “Formulaire POST vers des fournisseurs externes”. Vous devez également spécifier dans la requête l’URL (merchantReturnUrl) vers laquelle le client sera redirigé à la fin du paiement par wallet externe. Vous devez ensuite appeler le service paymentProviderFinalize afin de finaliser la transaction.

  • paymentTokenGenerate

    Génère un token de paiement pour un paiement avec hosted fields

  • recycle

    Cette fonction permet de créer une nouvelle transaction à partir des données bancaires d’une transaction précédente. Cette opération est similaire à la duplication, mais avec des limites. Elle vous permet de recycler une transaction expirée ou refusée ou capturée partiellement (le montant n’a pas été entièrement réglé) sans dépasser le montant de la transaction initiale.

  • refund

    Cette opération vous permet de rembourser une transaction en créditant le compte du client et en débitant votre compte.

  • refuseChallenge

    Cette fonction vous permet de refuser le risque de fraude sur des transactions ayant un score de fraude orange. Une fois le challenge refusé, la transaction est refusée.

  • removeFromFraudList

    Cette opération permet de supprimer un numéro de carte, de token, de transaction (via le couple transactionIid/transactionDate ou transactionReference) de différents types de liste fraude.

  • searchMandate

    Cette opération permet de rechercher les mandats existants d’un client. Les mandats sont liés à un client donné seulement si le champ customerId a été fourni dans les paramètres de la requête initializeMandate.

  • signOff

    Cette opération permet de supprimer un wallet et les moyens de paiements associés. Si le compte n’existe pas, un code de réponse 01 est retourné. Si la suppression a fonctionné, le code de réponse 00 est retourné avec la date de suppression.

  • updatePaymentMean

    Cette opération vous permet de mettre à jour l’un des moyens de paiement contenu dans le wallet d’un client. Si le compte ou le moyen de paiement n’existe pas, un code de réponse 01 est retourné. Si la mise à jour a fonctionné, le code de réponse 00 est retourné avec la date de la mise à jour.

  • validate

    Cette fonction permet de déclencher la remise en paiement d’une transaction. Elle vous permet de faire du paiement différé en débitant votre client à l’expédition des produits achetés.

  • walletCheckEnrollment

    Cette opération permet d’initialiser un paiement par wallet avec le processus 3-D Secure.

    Cette requête initialise une transaction sur la plateforme Sogenactif et vérifie si la carte récupérée à partir du wallet est inscrite au programme 3-D Secure. Si la carte est inscrite à 3-D Secure, vous recevez comme réponse une URL sécurisée (redirectionUrl) vers laquelle le client doit être redirigé pour poursuivre son authentification. Cette redirection doit être réalisée par le biais d’un formulaire POST, voir la partie “Formulaire POST vers l’ACS”. Dans le cas contraire, vous avez la possibilité de poursuivre le paiement sans effectuer de redirection en appelant directement la méthode cardValidateAuthenticationAndOrder.

  • walletCreditHolder

    Cette fonction vous permet de créditer vos clients via leur wallet sans transaction préalable.

  • walletIssuerWalletFinalize

    Cette opération permet de finaliser un paiement wallet pour les wallets externes.

    Une telle requête est obligatoire pour connaître le résultat d’un ordre de paiement wallet effectué par le biais d’un wallet externe. Elle doit être appelée une fois que vous avez reçu le formulaire POST du wallet externe via la merchantReturnUrl (voir requête walletIssuerWalletInitialize).

  • walletIssuerWalletInitialize

    Cette requête permet d’initialiser un paiement one-click avec un wallet externe :

    Une telle requête est obligatoire pour récupérer les données de redirection et l’url vers laquelle rediriger l’acheteur vers les pages d’authentification du wallet externe enrôlé dans un wallet “Sogenactif. Si l’étape d’initialisation a réussi, vous recevez en réponse une URL sécurisée (redirectionUrl) vers laquelle le client doit être redirigé pour poursuivre la procédure de paiement one-click. Cette redirection doit être réalisée par le biais d’un formulaire POST, voir la partie “Formulaire POST vers des fournisseurs externes”. Vous devez également spécifier dans la requête l’URL (merchantReturnUrl) vers laquelle le client sera redirigé à la fin du paiement one-click avec un wallet externe. Vous devez ensuite appeler le service walletIssuerWalletFinalize afin de finaliser la transaction.”

  • walletOrder

    Cette fonction permet de créer un paiement avec une carte enrôlée dans le wallet “Sogenactif.”

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