Release 24.5

go directly to content

Search by keywords

walletManagementInit

To search in the page use Ctrl+F on your keyboard

Allows to initialize a wallet management kinematic with “Sherlock’s Walletpage.”

Recommended interfaceVersion:

  • POST : HP_3.0
  • JSON/SOAP : WMR_WS_3.0

  • PROD
    https://sherlocks-payment-webinit.secure.lcl.fr/rs-services/v2/walletManagementInit
    method
    POST
  • SIMU
    https://sherlocks-payment-webinit-simu.secure.lcl.fr/rs-services/v2/walletManagementInit
    method
    POST
  • PROD
    https://sherlocks-payment-webinit.secure.lcl.fr/walletManagementInit
    method
    POST
  • SIMU
    https://sherlocks-payment-webinit-simu.secure.lcl.fr/walletManagementInit
    method
    POST
  • PROD
    https://sherlocks-payment-webinit.secure.lcl.fr/services/v2/walletManagementInit
    method
    POST
  • SIMU
    https://sherlocks-payment-webinit-simu.secure.lcl.fr/services/v2/walletManagementInit
    method
    POST

Required

Optional

Request sample

            {
    "interfaceVersion":"WMR_WS_2.5",
    "keyVersion":"1",
    "merchantId":"033000254447216",
    "merchantWalletId":"2",
    "normalReturnUrl":"https://www.normalreturnurl.com",
    "requestDateTime":"2022-03-29T12:41:55.227+02:00",
    "seal":"86019473e484772dd19193ca9912330784c8def96c42e39192d262ee4710c8a8"
}

        
            merchantId=011223744550001|normalReturnUrl=http://www.normalreturnurl.com| merchantWalletId=w53465|keyVersion=1|requestDateTime=2015-08-05T16:18:09.415+02:00|InterfaceVersion=HP_2.4|Seal=21a57f2fe765e1ae4a8bf15d73fc1bf2a533f547f2343d12a499d9c0592044d4

        
            <soapenv:Body>
      <urn:walletManagementInit>
         <urn:input>
            <urn:responseKeyVersion>1</urn:responseKeyVersion>
            <urn:merchantWalletId>9865578</urn:merchantWalletId>
            <urn:requestDateTime> 2014-12-19T14:06:06.273+01:00</urn:requestDateTime>
            <urn:interfaceVersion>WMR_WS_2.5</urn:interfaceVersion>
            <urn:merchantId>011223744550001</urn:merchantId>
         <urn:normalReturnUrl>http://www.normalreturnurl.com</urn:normalReturnUrl>
            <urn:responseEncoding>base64</urn:responseEncoding>
         </urn:input>
      </urn:walletManagementInit >
   </soapenv:Body>

Required

  • seal
    presence
    Required
    Interface version
    2.0

    Message seal used to ensure the integrity of the request and the authentication of sender / receiver of the message.

Optional

  • redirectionData
    presence
    Optional
    Interface version
    2.0

    In case of 3-D Secure payment, contains the context of the transaction retrieved from the cardCheckEnrollment method. In case of 3-D Secure server Standalone, it contains the Payer Authentication Request (PAReq) that the merchant must transmit to ACS for 3-D Secure authentication (format: base 64 encoded).In case of external payment provider, contains the context of the transaction sent by the merchant during the transaction initialisation.

  • redirectionStatusCode
    presence
    Optional
    Interface version
    2.0

    Response code returned by Sherlock’s when redirecting (e.g. redirecting to the ACS, to Sherlock’s server…). Indicates whether redirecting is possible or not.

    List of values
    00
    • In response to paymentWebInit: transaction initialized
    • In response to walletCheckEnrollment and cardCheckEnrollment: Carte enrolled
    01
    In response to cardCheckEnrollment and walletCheckEnrollment: card non 3-D Secure enrolled
    03
    Merchant contract invalid
    10
    Undefinied card enrollment (in response to cardCheckEnrollment and walletCheckEnrollment only)
    12
    Invalid transaction, check parameters transferred in the request
    14
    Invalid payment mean data (ex: PAN)
    30
    Format error (Webinit ERROR)
    34
    Suspicion of fraud, signature error (Webinit ERROR)
    80
    Error during DS interrogation
    89
    MPI session expired
    91
    Merchant not configured in the 3-D Secire server
    94
    • In response to paymentWebInit: transaction duplicated. The transactionReference of this transaction has already been used
    • In response to cardCheckEnrollment or walletCheckEnrollment: error during the enrollment verification call
    99
    Internal error
  • redirectionStatusMessage
    presence
    Optional
    Interface version
    2.0

    Additional information that is returned with redirectionStatusCode.

  • redirectionUrl
    presence
    Optional
    Interface version
    2.0

    In case of an enrollment check, contains the redirection URL to the ACS required for the cardholder authentication. In case of Sherlock’s In-App payment, contains the URL of the next request. In case of 3-D Secure Standalone, contains the redirection URL to the ACS required for the cardholder authentication.

  • redirectionVersion
    presence
    Optional
    Interface version
    2.0

    Version of the redirection message.

Response sample

            {
    "redirectionData":"4AgbsrffvPgzDghQysbOJIZBJTZsk1KNlTmoOCtSORkMfzQgSR5OEw0gAE2bAAFb5y08Pvgra_7toedp6myyilCgXQRNGFXHTPBBvi1_9PNoPTfgoPO4PNo20aNt6yb5YozbgoGdN6riSx24sSc49EVrB93g9YRFX4n3mM85FC7HrYxZYGLJ4Q5IztBJPv_yz5VSz2Ff1Lzn4Aj8fMWJQrPQmqFFO2zNTQxWd3BFpNu94D5KGxS4wQ-zj0f5ZqNsHAYN8lKdup8ZOZNQVi2uxwNIDRBXLuKf7AI3SXGxEPcYes9x0IkKNxUllWSMyIjxmEb92lj7DEVqXcwG9uRk-jCIz0ivTJJ1p8GE_zboKHTtSJQ0-DVJjb9u3TJND0ab4r2DuBbALTsqGjrU2GH3CTimUQMb0DdQXBLy-iYSJBrCOklfKHVVxHcCYRdu9a7C69HMJonIrx-TH8jPzAMwN59RoQUGeugUN2axeDQ75U_7hBXiSyLOolGHN6A79ECq0x0C4diHPB-iYEcS0UwXB_c2VklnHPnmuLqIed0A3txPmB34vf5fifFJc3Sa5KxT5XdjCW5y13ZKe5RC3WOgvZVetdRV4-x16_sSb-hJ76cMGWBmn-j29a8wy_o9cUeP-7GoQsGYvuPPdU6LnGO1y6QlHIScwdFRo7Ed0F1WgoQuX7oWD0ZLrGAUjvPWss-f4YCFvVIfOYhb6a3unLFMTY_mrI1Y1k5iXEpy-42dC91EyHiX6jF0iEDoWMLLfMCalQknaJspAjOcwdyVCGX9DAVr72OI3L7jpTc6Txnr5KtxVUM4gOra0nmRPEmlb_1aASYjjtoNdIpNyK819KrsOWpnfy7y9iHOOqb64gMMvupsKo3ZXhwZBf7Zjr375fY92rwcPuX3U4cG-gpGaK9_txTOiXha7fvIaqiRNdOT3kprBiK4IrWZ9tRFzvy6VJgQAMcVSEe9FCKiUYyMpByPldi94CLbpLW_nWlCLZZo-KVFeEiYbj0EnETMUzJsW33rh143l_w5wgg19EmnUeMvEqryk_zaDaLosrrrKUwWkFyRimi9u457UXQQNHBUXW-5GsrimZdsRsNdeU7v-m_g8k9QVeD_SHJOkJkyHNgtJlu0PSjqkFsgsurs_mPb_JZD3sFEAN70MwnfDoV9rBvzY8y88qf5GbI7b87ZGW8qsETbX-cR27DoLaNEVuSPqtHA9ysg-4LskL7OzBNMWBxP7ZUJJ2ibKQIznMHclQhl_QxA6x6MRjUG81_xF5YcDlDZtTtjxoMrrZoxC4mW3V6FKUNjB5R9AIXIAMGhvEQbgQBSFkN_Un1mWuHmQCbPPkZW6TlF3Mq9EowaC06qFT2i4nxg0uv-TnUIgF7dQakfmncD8mrT4qd_4s4EYiXNywnkqf9y4oHIIBVYJZQop-UqgrO-vcc9Dly5vkaFc-NmiZm_KHA9aJBJzSdeUhk6L1zpPFAfaaFo372H2IfgdTtarEmukVvlK9ghlInepaJiyDzUdZZ1gvu4eSQInj8jSksfNjU184KvkQMvfI9VHOWgSlr0KXmJvwaedBG_by7Lfu8QbOuPW-4F2p0NNNwqn2WlZBguDevYLwQhCsCHJ5Z1MXowpu9HYL10_Gn5bYjnwPQPzNaC2UQ5AJ7b92EDJUQ1vuGxRzoON_i95p1HrTv_5byQayzhr5eX1vxjIjjhmTsI0ytlcUYgVqNnz3aRiCRTOUGMB0bMefpxht4GIvwT2wwoblsQmp4reGOeO2ncpC4D8mrT4qd_4s4EYiXNywnk4UU77eXpMKCPY00_Dmc00q6qRgtKUfrJKrFsICbHuZ1O8Q249qlgcDTiCzx18NLpACW6sJaXQySgYoxqSQY5A0V4SJhuPQScRMxTMmxbfeu1AEwTu5ZI-KqvmYvLSTVETHay8DAHLVVYKm7VzSdTCkGEjFKKaT1dbTauj4jEUx8XZlJ02HT6m77B9lV5JmbU5i5igDZEBgDz5RY3-K9P6MPVr484eZtoBd8C3jHt-CZ1CgJ8KLF7uH7NFCp7gBgpGN-ZSms_RrtRzmv29l0Q-sf6UAF3duLDaUXwMAq5CP-oyAQ5HE6RAXCNchoUfUufYM9xVk2gLaJ2Eb9U09iGCltf-kvIdS3kKMyqqhgNOzl4QG7DLXkZgA2SnEWxdLSSyGHFFyuUXUzeGYBLbMY5b2oYjI3rupUfe6ZOtGYDwW7WNGML2MBvDIuP3SH3Yb2eAEx23yzYNZ6dq5TfPSNtRDxQH2mhaN-9h9iH4HU7WqwUNvqsyuPDhQPAXVZ8NpalJ8oNBlQwSHTlw6RdNahhN_c2VklnHPnmuLqIed0A3twyMO_gtWiX185a4pqrLnhS_f3MqkJZXYrtTOJxLUUoNaJ7erHjNvszogqw6uj2XUQAD2SZ9ERDPMZD8QtodZzRA5V7Rs-AhJ4-L0rjy0k7z0B10vKfdKsYPOs-VfnUk7zUfNbvb3d2HX8fZgp7PWdx",
    "redirectionStatusCode":"00",
    "redirectionStatusMessage":"Process succeeded",
    "redirectionUrl":"https://payment-gateway.net/",
    "redirectionVersion":"WMR_WS_2.0",
    "seal":"9c5ca13b5ea30a06d201629d5a9f7eb9692fa08c9663da443b387fb4f7faa905"
}
        
            redirectionStatusCode=00|redirectionStatusMessage=Process succeeded|redirectionUrl=https://payment-gateway.net/|redirectionVersion=WMR_WS_2.0|seal=9c5ca13b5ea30a06d201629d5a9f7eb9692fa08c9663da443b387fb4f7faa905|redirectionData=4AgbsrffvPgzDghQysbOJIZBJTZsk1KNlTmoOCtSORkMfzQgSR5OEw0gAE2bAAFb5y08Pvgra_7toedp6myyilCgXQRNGFXHTPBBvi1_9PNoPTfgoPO4PNo20aNt6yb5YozbgoGdN6riSx24sSc49EVrB93g9YRFX4n3mM85FC7HrYxZYGLJ4Q5IztBJPv_yz5VSz2Ff1Lzn4Aj8fMWJQrPQmqFFO2zNTQxWd3BFpNu94D5KGxS4wQ-zj0f5ZqNsHAYN8lKdup8ZOZNQVi2uxwNIDRBXLuKf7AI3SXGxEPcYes9x0IkKNxUllWSMyIjxmEb92lj7DEVqXcwG9uRk-jCIz0ivTJJ1p8GE_zboKHTtSJQ0-DVJjb9u3TJND0ab4r2DuBbALTsqGjrU2GH3CTimUQMb0DdQXBLy-iYSJBrCOklfKHVVxHcCYRdu9a7C69HMJonIrx-TH8jPzAMwN59RoQUGeugUN2axeDQ75U_7hBXiSyLOolGHN6A79ECq0x0C4diHPB-iYEcS0UwXB_c2VklnHPnmuLqIed0A3txPmB34vf5fifFJc3Sa5KxT5XdjCW5y13ZKe5RC3WOgvZVetdRV4-x16_sSb-hJ76cMGWBmn-j29a8wy_o9cUeP-7GoQsGYvuPPdU6LnGO1y6QlHIScwdFRo7Ed0F1WgoQuX7oWD0ZLrGAUjvPWss-f4YCFvVIfOYhb6a3unLFMTY_mrI1Y1k5iXEpy-42dC91EyHiX6jF0iEDoWMLLfMCalQknaJspAjOcwdyVCGX9DAVr72OI3L7jpTc6Txnr5KtxVUM4gOra0nmRPEmlb_1aASYjjtoNdIpNyK819KrsOWpnfy7y9iHOOqb64gMMvupsKo3ZXhwZBf7Zjr375fY92rwcPuX3U4cG-gpGaK9_txTOiXha7fvIaqiRNdOT3kprBiK4IrWZ9tRFzvy6VJgQAMcVSEe9FCKiUYyMpByPldi94CLbpLW_nWlCLZZo-KVFeEiYbj0EnETMUzJsW33rh143l_w5wgg19EmnUeMvEqryk_zaDaLosrrrKUwWkFyRimi9u457UXQQNHBUXW-5GsrimZdsRsNdeU7v-m_g8k9QVeD_SHJOkJkyHNgtJlu0PSjqkFsgsurs_mPb_JZD3sFEAN70MwnfDoV9rBvzY8y88qf5GbI7b87ZGW8qsETbX-cR27DoLaNEVuSPqtHA9ysg-4LskL7OzBNMWBxP7ZUJJ2ibKQIznMHclQhl_QxA6x6MRjUG81_xF5YcDlDZtTtjxoMrrZoxC4mW3V6FKUNjB5R9AIXIAMGhvEQbgQBSFkN_Un1mWuHmQCbPPkZW6TlF3Mq9EowaC06qFT2i4nxg0uv-TnUIgF7dQakfmncD8mrT4qd_4s4EYiXNywnkqf9y4oHIIBVYJZQop-UqgrO-vcc9Dly5vkaFc-NmiZm_KHA9aJBJzSdeUhk6L1zpPFAfaaFo372H2IfgdTtarEmukVvlK9ghlInepaJiyDzUdZZ1gvu4eSQInj8jSksfNjU184KvkQMvfI9VHOWgSlr0KXmJvwaedBG_by7Lfu8QbOuPW-4F2p0NNNwqn2WlZBguDevYLwQhCsCHJ5Z1MXowpu9HYL10_Gn5bYjnwPQPzNaC2UQ5AJ7b92EDJUQ1vuGxRzoON_i95p1HrTv_5byQayzhr5eX1vxjIjjhmTsI0ytlcUYgVqNnz3aRiCRTOUGMB0bMefpxht4GIvwT2wwoblsQmp4reGOeO2ncpC4D8mrT4qd_4s4EYiXNywnk4UU77eXpMKCPY00_Dmc00q6qRgtKUfrJKrFsICbHuZ1O8Q249qlgcDTiCzx18NLpACW6sJaXQySgYoxqSQY5A0V4SJhuPQScRMxTMmxbfeu1AEwTu5ZI-KqvmYvLSTVETHay8DAHLVVYKm7VzSdTCkGEjFKKaT1dbTauj4jEUx8XZlJ02HT6m77B9lV5JmbU5i5igDZEBgDz5RY3-K9P6MPVr484eZtoBd8C3jHt-CZ1CgJ8KLF7uH7NFCp7gBgpGN-ZSms_RrtRzmv29l0Q-sf6UAF3duLDaUXwMAq5CP-oyAQ5HE6RAXCNchoUfUufYM9xVk2gLaJ2Eb9U09iGCltf-kvIdS3kKMyqqhgNOzl4QG7DLXkZgA2SnEWxdLSSyGHFFyuUXUzeGYBLbMY5b2oYjI3rupUfe6ZOtGYDwW7WNGML2MBvDIuP3SH3Yb2eAEx23yzYNZ6dq5TfPSNtRDxQH2mhaN-9h9iH4HU7WqwUNvqsyuPDhQPAXVZ8NpalJ8oNBlQwSHTlw6RdNahhN_c2VklnHPnmuLqIed0A3twyMO_gtWiX185a4pqrLnhS_f3MqkJZXYrtTOJxLUUoNaJ7erHjNvszogqw6uj2XUQAD2SZ9ERDPMZD8QtodZzRA5V7Rs-AhJ4-L0rjy0k7z0B10vKfdKsYPOs-VfnUk7zUfNbvb3d2HX8fZgp7PWdx

Changelog


Interface version Data Attendance Container
2.0 automaticResponseUrl Request
2.0 billingAddress Request
2.0 addressAdditional3 Container
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 addressAdditional1 Container
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 addressAdditional2 Container
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.4 businessName Container
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 city Container
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 company Container
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 country Container
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 postBox Container
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 state Container
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 street Container
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 streetNumber Container
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 zipCode Container
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 billingContact Request
    2.0 email Container
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 firstname Container
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 gender Container
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.2 initials Container
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 lastname Container
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.4 legalId Container
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 mobile Container
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 phone Container
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.4 positionOccupied Container
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 title Container
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 customerAddress Request
    2.0 customerContact Request
    2.0 customerData Request
    2.0 birthCity Container
  • customerData
  • holderData
    • 2.0 birthCountry Container
  • customerData
  • holderData
    • 2.0 birthZipCode Container
  • customerData
  • holderData
    • 2.0 birthDate Container
  • customerData
  • holderData
    • 2.0 nationalityCountry Container
  • customerData
  • holderData
    • 2.0 newPassword Container
  • customerData
  • holderData
    • 2.0 password Container
  • customerData
  • holderData
    • 2.0 customerId Request
    2.0 customerIpAddress Request
    2.0 customerLanguage Request
    2.0 deliveryAddress Request
    2.0 deliveryContact Request
    2.0 fraudData Request
    2.0 allowedIpCountryList Container
  • fraudData
    • 2.0 deniedIpCountryList Container
  • fraudData
    • 2.0 bypass3DS Container
  • fraudData
    • 2.0 bypassCtrlList Container
  • fraudData
    • 2.0 allowedCardArea Container
  • fraudData
    • 2.0 allowedIpArea Container
  • fraudData
    • 2.0 deniedCardArea Container
  • fraudData
    • 2.0 deniedCardCountryList Container
  • fraudData
    • 2.0 allowedCardCountryList Container
  • fraudData
    • 2.0 deniedIpArea Container
  • fraudData
    • 2.0 bypassInfoList Container
  • fraudData
    • 2.0 riskManagementDynamicSettingList Container
  • fraudData
    • 2.0 riskManagementDynamicSetting Container
  • riskManagementDynamicSettingList
    • 2.0 riskManagementDynamicParam Container
  • riskManagementDynamicSetting
    • 2.0 riskManagementDynamicValue Container
  • riskManagementDynamicSetting
    • 2.0 holderAddress Request
    2.0 holderContact Request
    2.0 holderData Request
    3.0 interfaceVersionAutomaticResponse Request
    3.0 interfaceVersionNormalResponse Request
    2.2 intermediateServiceProviderId Request
    2.4 mandateId Request
    2.6 merchantName Request
    2.0 merchantSessionId Request
    2.6 merchantUrl Request
    2.0 paymentMeanBrandList Request
    2.4 paymentMeanData Request
    2.4 sdd Container
  • paymentMeanData
    • 2.4 mandateAuthentMethod Container
  • sdd
    • 2.4 mandateCertificationType Container
  • sdd
    • 2.5 responseEncoding Request
    2.0 responseKeyVersion Request
    2.0 returnContext Request
    2.2 sealAlgorithm Request
    2.0 templateName Request
    2.4 transactionActors Request
    2.0 walletActionNameList Request
    2.0 interfaceVersion Request
    2.2 keyVersion Request
    2.0 merchantId Request
    2.0 merchantWalletId Request
    2.0 normalReturnUrl Request
    2.0 requestDateTime Request
    2.2 seal Request/Response
    2.0 redirectionData Response
    2.0 redirectionStatusCode Response
    2.0 redirectionStatusMessage Response
    2.0 redirectionUrl Response
    2.0 redirectionVersion Response
    Back to top Need help?

    This site uses trackers to improve your experience, perform analysis and researches on your use of Sherlock's documentation website.
    You have several options:
    Closing this banner you refuse the use of trackers on your device.

    Configuration