logo Mercanet

Release 24.5

aller directement au contenu

Rechercher par mots clés

initializeMandate

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

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.

interfaceVersion recommandée : MR_WS_2.55

Avant de lire ce document nous vous conseillons

  • Conseillé
    1. Moyens de paiement
    2. Virements et prélèvements

    SDD

    Documentation fonctionnelle, technique et guides utilisateurs pour vous aider à intégrer la solution de paiement en ligne Mercanet.

    Ouvrir ce document dans un nouvel onglet SDD

  • PROD
    https://office-server.mercanet.com/rs-services/v2/mandate/initializeMandate
    méthode
    POST
  • TEST
    https://office-server-mercanet.test.sips-services.com/rs-services/v2/mandate/initializeMandate
    méthode
    POST
  • PROD
    https://office-server.mercanet.com/services/v2/mandate?wsdl
    méthode
    POST
  • TEST
    https://office-server-mercanet.test.sips-services.com/services/v2/mandate?wsdl
    méthode
    POST

Obligatoire

Optionnel

Exemple de requête

            {
  "customerAddress": {
    "city": "City",
    "country": "FRA",
    "street": "street name",
    "streetNumber": "123",
    "zipCode": "12345"
  },
  "customerContact": {
    "email": "test@sips.com",
    "firstname": "Firstname",
    "gender": "M",
    "lastname": "Lastname"
  },
  "iban": "FR123456456546546546546546",
  "interfaceVersion": "MR_WS_2.18",
  "keyVersion": "1",
  "merchantId": "011223344550000",
  "merchantReturnUrl": "https://mywebsite/return.jsp",
  "paymentMeanAlias": "alias",
  "seal": "fc24b9e6bd7a433d258a1df1a8af2698b917d1632aaa1bc12c5c8f45adbeba11"
}

        
                  <urn:initializeMandate>
         <urn:input>
            <urn:paymentMeanAlias>alias</urn:paymentMeanAlias>
            <urn:merchantReturnUrl>https://mywebsite/request.jsp</urn:merchantReturnUrl>
            <urn:merchantId>011223344550000</urn:merchantId>
            <urn:interfaceVersion>MR_WS_2.18</urn:interfaceVersion>
            <urn:seal>a7eb2054b6054bedc02e918e7eeb07e3bcecfca945b3e1697fe2a2c4cc3b52a6</urn:seal>
            <urn:keyVersion>1</urn:keyVersion>
            <urn:customerContact>
               <urn:email>test@worldline.com</urn:email>
               <urn:firstname>firstName</urn:firstname>
               <urn:gender>M</urn:gender>
               <urn:lastname>Lastname</urn:lastname>
            </urn:customerContact>
            <urn:customerAddress>
               <urn:city>City</urn:city>
               <urn:country>FRA</urn:country>
               <urn:street>Street name</urn:street>
               <urn:streetNumber>123</urn:streetNumber>
               <urn:zipCode>12345</urn:zipCode>
            </urn:customerAddress>
            <urn:iban>FR7617906001120227366700148</urn:iban>
         </urn:input>
      </urn:initializeMandate>

Obligatoire

  • seal
    présence
    Obligatoire
    Interface version
    2.0

    Sceau du message utilisé pour assurer l’intégrité de la requête et l’authentification de l’émetteur/destinataire du message (partage de la clé secrète).

Optionnel

  • acquirerResponseCode
    présence
    Optionnel
    Interface version
    2.0

    Code réponse retourné par l’acquéreur lors d’une demande d’autorisation.

    Liste des valeurs
    00
    Transaction approuvée ou traitée avec succès
    02
    Contactez l’émetteur du moyen de paiement
    03
    Accepteur invalide
    04
    Conservez le support du moyen de paiement
    05
    Ne pas honorer
    07
    Conservez le support du moyen de paiement, conditions spéciales
    08
    Approuvez après l’identification
    12
    Transaction invalide
    13
    Montant invalide
    14
    Coordonnées du moyen de paiement invalides
    15
    Émetteur du moyen de paiement inconnu
    17
    Paiement interrompu par l’acheteur
    20
    Réponse erronée (erreur dans le domaine serveur)
    24
    Opération impossible
    25
    Transaction inconnue
    30
    Erreur de format
    31
    Id de l’organisation d’acquisition inconnu
    33
    Moyen de paiement expiré (Paypal / Cofidis)
    34
    Suspicion de fraude
    40
    Fonction non supportée
    41
    Moyen de paiement perdu
    43
    Moyen de paiement volé
    51
    Provision insuffisante ou crédit dépassé
    54
    Moyen de paiement expiré (CB / Visa / MC / WLAcq / BCMC)
    55
    PIN invalide
    56
    Moyen de paiement manquant dans le fichier
    57
    Transaction non autorisée pour ce porteur
    58
    Transaction interdite au terminal
    59
    Suspicion de fraude
    60
    L’accepteur du moyen de paiement doit contacter l’acquéreur
    61
    Excède le maximum autorisé
    62
    Transaction en attente de confirmation de paiement
    63
    Règles de sécurité non respectées
    65
    Nombre de transactions du jour dépassé
    68
    Réponse non parvenue ou reçue trop tard
    75
    Nombre de tentatives de saisie des coordonnées du moyen de paiement dépassé
    87
    Terminal inconnu
    90
    Arrêt momentané du système
    91
    Emetteur du moyen de paiement inaccessible
    92
    La transaction ne contient pas les informations suffisantes pour être redirigées vers l’organisme d’autorisation
    93
    La transaction n’a pas pu aboutir car non conforme à la réglementation
    94
    Transaction dupliquée
    96
    Mauvais fonctionnement du système
    97
    Requête expirée: transaction refusée
    98
    Serveur inaccessible
    99
    Incident technique
    A1
    Transaction refusée pour cause d’absence des données d’authentification 3-D Secure
    A4
    Transaction refusée pour cause de mauvaise utilisation de l’exemption d’authentification 3-D Secure
    R1
    Le porteur (ou sa banque) a révoqué les paiements récurrents effectués chez un commerçant
    R3
    Le porteur (ou sa banque) a révoqué tous les paiements récurrents
  • errorFieldName
    présence
    Optionnel
    Interface version
    2.21

    Nom du champ en erreur dans la requête. Présent lorsque responseCode = 12 ou 30.

  • mandateId
    présence
    Optionnel
    Interface version
    2.0

    Numéro de mandat.

  • mandateResponseCode
    présence
    Optionnel
    Interface version
    2.0

    Code réponse fourni par le service de gestion d’un mandat.

    Liste des valeurs
    00
    Opération sur mandat acceptée
    03
    Contrat commerçant invalide
    05
    Opération sur mandat refusé
    12
    Mandat invalide, vérifier les paramètres transférés dans la requête
    17
    Annulation de l’acheteur
    25
    Mandat non trouvé
    30
    Erreur de format
    34
    Suspicion de fraude (seal erroné)
    40
    Fonction non supportée : l’opération que vous souhaitez réaliser ne fait pas partie de la liste des opérations auxquelles vous êtes autorisés
    99
    Problème temporaire au niveau du serveur Mercanet
  • messageVersion
    présence
    Optionnel
    Interface version
    2.0

    Version des paramètres de redirection.

  • redirectionData
    présence
    Optionnel
    Interface version
    2.0

    Dans le cas d’un paiement 3-D Secure, contient le contexte de la transaction récupéré en sortie de la méthode cardCheckEnrolment. Dans le cas de 3-D Secure Server Standalone, Message PARes que le commerçant doit transmettre à l’ACS (Access Control Server) pour l’authentification 3-D Secure du porteur (format : encodage base 64).Dans le cas d’un paiement via un partenaire externe, contient le contexte de la transaction envoyée par le commerçant pendant l’initialisation de la transaction.

  • redirectionUrl
    présence
    Optionnel
    Interface version
    2.0

    Dans le cas d’une vérification d’enrôlement, contient l’URL de redirection vers l’ACS requis pour l’authentification du porteur. Dans le cas d’un paiement in-App, contient l’URL du prochain appel.Dans le cas de 3-D Secure standalone, contient l’URL de redirection vers l’ACS requis pour l’authentification du porteur.

Exemple de réponse

            {
  "mandateResponseCode": "00",
  "acquirerResponseCode": "00",
  "redirectionUrl": "https://payment-web.test.sips-services.com/paymentprovider/initsps",
  "redirectionData": "bt1QVw4zgOYphloN0S7DMHpIAJfrMks9H/...j3MFRNbExX",
  "mandateId": "000000000000000826",
  "messageVersion": "0.1",
  "seal": "9019f36306c3c5de4ff8ea9bc4fcc9ebca236cb350c348c6951a81f86d0c6c60"
}

        
                  <initializeMandateResponse xmlns="urn:sips:cn:contract:office:mandatemanagement:v2">
         <output>
            <responseCode>00</responseCode>
            <acquirerResponseCode>00</acquirerResponseCode>
            <redirectionUrl>https://payment-web.test.sips-services.com/paymentprovider/initsps</redirectionUrl>
            <redirectionData>bt1QVw4zgOYphloN0S7DMM9DY...+KSFdhTJlLnw==</redirectionData>
            <messageVersion>0.1</messageVersion>
            <seal>bbd5cc75da6794009791ddb78431828aff33d12e2fe4085be079cdadf29c33e9</seal>
         </output>
      </initializeMandateResponse>

Changelog


Interface version Donnée Présence Conteneur
2.0 customerAddress Requête
2.0 addressAdditional3 Conteneur
  • customerAddress
    • 2.0 businessName Conteneur
  • customerAddress
    • 2.0 country Conteneur
  • customerAddress
    • 2.0 city Conteneur
  • customerAddress
    • 2.0 company Conteneur
  • customerAddress
    • 2.0 addressAdditional1 Conteneur
  • customerAddress
    • 2.0 addressAdditional2 Conteneur
  • customerAddress
    • 2.0 postBox Conteneur
  • customerAddress
    • 2.0 state Conteneur
  • customerAddress
    • 2.0 street Conteneur
  • customerAddress
    • 2.0 streetNumber Conteneur
  • customerAddress
    • 2.0 zipCode Conteneur
  • customerAddress
    • 2.0 customerContact Requête
    2.0 email Conteneur
  • customerContact
    • 2.0 firstname Conteneur
  • customerContact
    • 2.0 gender Conteneur
  • customerContact
    • 2.0 initials Conteneur
  • customerContact
    • 2.0 lastname Conteneur
  • customerContact
    • 2.0 legalId Conteneur
  • customerContact
    • 2.0 mobile Conteneur
  • customerContact
    • 2.0 phone Conteneur
  • customerContact
    • 2.0 positionOccupied Conteneur
  • customerContact
    • 2.0 title Conteneur
  • customerContact
    • 2.0 customerId Requête
    2.0 customerLanguage Requête
    2.0 intermediateServiceProviderId Requête
    2.0 mandateId Requête/Réponse
    2.0 paymentMeanData Requête
    2.0 returnContext Requête
    2.0 sealAlgorithm Requête
    2.0 transactionActors Requête
    2.0 iban Requête
    2.0 interfaceVersion Requête
    2.0 keyVersion Requête
    2.0 merchantId Requête
    2.0 merchantReturnUrl Requête
    2.0 paymentMeanAlias Requête
    2.0 seal Requête/Réponse
    2.0 acquirerResponseCode Réponse
    2.21 errorFieldName Réponse
    2.0 mandateResponseCode Réponse
    2.0 messageVersion Réponse
    2.0 redirectionData Réponse
    2.0 redirectionUrl Réponse
    Retourner en haut de page Besoin d'aide ?

    Besoin d'aide ?

    Contacter le support
    Fermer