logo Mercanet

Release 25.5

aller directement au contenu

Rechercher par mots clés

finalizeMandate

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

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

interfaceVersion recommandée : MR_WS_2.58

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/finalizeMandate
    méthode
    POST
  • TEST
    https://office-server-mercanet.test.sips-services.com/rs-services/v2/mandate/finalizeMandate
    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

  • interfaceVersion
    présence
    Obligatoire
    Interface version
    2.0

    Version de l’interface utilisée. Elle est composée d’un préfixe qui varie selon la fonction utilisée et d’un numéro de version (ex : IR_WS_2.47).

    Veuillez-vous référer à la page de la fonction pour connaître la valeur à utiliser. Utilisez le dernier numéro d’interfaceVersion.

    Liste des valeurs
    MR_WS_2.
    interface Office (M2M) (SOAP/JSON) pour les fonctions liées aux mandats.
  • keyVersion
    présence
    Obligatoire
    Interface version
    2.0

    Version de la clé secrète du commerçant utilisée pour calculer l’empreinte du message (clé stockée par le commerçant pour vérifier l’empreinte des notifications automatiques et manuelles).

  • merchantId
    présence
    Obligatoire
    Interface version
    2.0

    Identifiant de la boutique, sa valeur est fournie par Mercanet au commerçant lors de l’inscription de sa boutique.

  • messageVersion
    présence
    Obligatoire
    Interface version
    2.0

    Version des paramètres de redirection.

  • redirectionData
    présence
    Obligatoire
    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.

  • 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

Exemple de requête

            {
  "interfaceVersion": "MR_WS_2.18",
  "keyVersion": "1",
  "merchantId": "011223344550000",
  "messageVersion": "0.1",
  "redirectionData": "O4ytL5JBCPDNASyhleIA57zt3cZJx...86aea7"
}

        
                  <urn:finalizeMandate>
         <urn:input>
            <urn:interfaceVersion>MR_WS_2.18</urn:interfaceVersion>
            <urn:merchantId>011223344550000</urn:merchantId>
            <urn:messageVersion>0.1</urn:messageVersion>
            <urn:redirectionData>O4ytL5JBCPDNASyhleIA...GAoqArcvXHEEY9WeeBQ7ppJCIEbLvVUUqFZYJDVPWFeW2YqLssk=</urn:redirectionData>
            <urn:keyVersion>1</urn:keyVersion>
            <urn:seal>fa92674c6f3f4d311a96f2948b9e4ffab61b2f8c284c384ec1cde1ba3e18fb76</urn:seal>
         </urn:input>
      </urn:finalizeMandate>

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

Exemple de réponse

            {
  "mandateResponseCode": "00",
  "bic": "AGRIFRPP879",
  "iban": "FR1233321114456666",
  "transactionActors": "BTOC",
  "paymentMeanData": {
    "sdd": {
      "mandateAuthentMethod": "MAIL_OTP",
      "mandateUsage": "RECURRENT",
      "mandateCertificationType": "E_BASIC"
    }
  },
  "customerContact": {
    "email": "test@sips.com",
    "firstname": "Firstname",
    "lastname": "Lastname"
  },
  "customerAddress": {
    "city": "City",
    "street": "street name",
    "streetNumber": "123",
    "zipCode": "12345"
  },
  "mandateId": "000000000000000827",
  "seal": "eecf79584ac1acb2d91949940dbebb856061c8dab7f6ed655b8a624742df7adc"
}

        
                  <finalizeMandateResponse xmlns="urn:sips:cn:contract:office:mandatemanagement:v2">
         <output>
            <responseCode>00</responseCode>
            <bic>AGRIFRPP123</bic>
            <iban>FR761123245648466700148</iban>
            <transactionActors>BTOC</transactionActors>
            <paymentMeanData>
               <sdd>
                  <mandateAuthentMethod>MAIL_OTP</mandateAuthentMethod>
                  <mandateUsage>RECURRENT</mandateUsage>
                  <mandateCertificationType>E_BASIC</mandateCertificationType>
               </sdd>
            </paymentMeanData>
            <paymentMeanAlias/>
            <customerContact>
               <email>test@sips.net</email>
               <firstname>Firstname</firstname>
               <lastname>Lastname</lastname>
               <legalId/>
               <positionOccupied/>
            </customerContact>
            <customerAddress>
               <city>City</city>
               <company/>
               <street>Street name</street>
               <streetNumber>7</streetNumber>
               <zipCode>75000</zipCode>
               <businessName/>
            </customerAddress>
            <mandateId>000000000000008912</mandateId>
            <seal>b6b6df35d94a2d9c0c8f3be354b2e80189c3cecd54e6ce1ba82d409e7a94a173</seal>
         </output>
      </finalizeMandateResponse>

Changelog


Interface version Donnée Présence Conteneur
2.0 intermediateServiceProviderId Requête
2.0 sealAlgorithm Requête
2.0 interfaceVersion Requête
2.0 keyVersion Requête
2.0 merchantId Requête/Réponse
2.0 messageVersion Requête/Réponse
2.0 redirectionData Requête
2.0 seal Requête/Réponse
2.0 acquirerResponseCode Réponse
2.0 bic Réponse
2.0 customerAddress Réponse
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 Réponse
    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.21 errorFieldName Réponse
    2.0 iban Réponse
    2.0 mandateId Réponse
    2.0 mandateResponseCode Réponse
    2.0 paymentMeanAlias Réponse
    2.0 paymentMeanData Réponse
    2.0 transactionActors Réponse
    Retourner en haut de page Besoin d'aide ?

    Besoin d'aide ?

    Contacter le support
    Fermer