logo Mercanet

Release 24.3

aller directement au contenu

Rechercher par mots clés

getMandateData

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

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

interfaceVersion recommandée : MR_WS_2.55

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

            {
  "interfaceVersion": "MR_WS_2.20",
  "keyVersion": "1",
  "mandateId": "000000000000000677",
  "merchantId": "011223344550000",
  "seal": "39b46a6656d6647b20ffc0d1351d863b7627d7838f7ded02f34a690d9a2d2b8c"
}

        
            <urn:getMandateData>
         <urn:input>
            <urn:interfaceVersion>MR_WS_2.18</urn:interfaceVersion>
            <urn:merchantId>011223344550000</urn:merchantId>
            <urn:mandateId>000000000000000667</urn:mandateId>
            <urn:keyVersion>1</urn:keyVersion>
            <urn:seal>ae13163cfb5c7c8adb39c032876323f6d34d22d378f95d3e05ef774af7f0a720</urn:seal>
         </urn:input>
</urn:getMandateData>

        

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",
  "acquirerResponseCode": "00",
  "mandateId": "000000000000000677",
  "mandateStatus": "ACTIVE",
  "bic": "123456789",
  "iban": "987654321",
  "transactionActors": "BTOC",
  "mandateUsage": "RECURRENT",
  "customerContact": {
    "lastname": "JOHAN JOHAN"
  },
  "customerAddress": {
    "city": "MockCity",
    "country": "FR",
    "street": "Street",
    "streetNumber": "1234",
    "zipCode": "11111"
  },
  "directDebitList": [
    {
      "orderId": "7419",
      "amount": 0
    },
    {
      "orderId": "3336",
      "amount": 0
    },
    {
      "orderId": "8901",
      "amount": 0
    }
  ],
  "seal": "cfff04f2baddfa04c1f731468ebe77dbc83ffca5a3af97e2dbd182762a6b0c8b"
}

        
                  <getMandateDataResponse xmlns="urn:sips:cn:contract:office:mandatemanagement:v2">
         <output>
            <responseCode>00</responseCode>
            <acquirerResponseCode>00</acquirerResponseCode>
            <mandateId>000000000000000667</mandateId>
            <mandateStatus>ACTIVE</mandateStatus>
            <bic>123456789</bic>
            <iban>987654321</iban>
            <transactionActors>BTOC</transactionActors>
            <mandateUsage>RECURRENT</mandateUsage>
            <debtorName>FirstName Lastname</debtorName>
            <customerContact>
               <email>firstname.lastname@maiil.com</email>
            </customerContact>
            <customerAddress>
               <city>MockCity</city>
               <country>FR</country>
               <street>Street</street>
               <streetNumber>1234</streetNumber>
               <zipCode>11111</zipCode>
            </customerAddress>
            <directDebitList>
               <directDebit>
                  <amount>100</amount>
               </directDebit>
               <directDebit>
                  <amount>200</amount>
               </directDebit>
               <directDebit>
                  <amount>200</amount>
               </directDebit>
            </directDebitList>
            <seal>f001a2d283afa8e2087e560e107d49d3100899df93f4ce0e06e814983f93f992</seal>
         </output>
      </getMandateDataResponse>

        

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 mandateId Requête/Réponse
2.0 merchantId 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.19 debtorName Réponse
    2.0 directDebitList Réponse
    2.0 directDebit Conteneur
  • directDebitList
  • 2.0 amount Conteneur
  • directDebit
  • 2.0 directDebitCreationDate Conteneur
  • directDebit
  • 2.0 directDebitStatus Conteneur
  • directDebit
  • 2.0 dueDate Conteneur
  • directDebit
  • 2.0 iban Réponse
    2.0 mandateCreationDate Réponse
    2.0 mandateLastUpdateDate Réponse
    2.0 mandateResponseCode Réponse
    2.0 mandateSignatureDate Réponse
    2.0 mandateStatus Réponse
    2.0 mandateUsage Réponse
    2.0 transactionActors Réponse
    Retourner en haut de page Besoin d'aide ?

    Besoin d'aide ?

    Fermer