Release 25.5

aller directement au contenu

Rechercher par mots clés

walletIssuerWalletInitialize

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

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 Sherlock’s. 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.

interfaceVersion recommandée : IR_WS_2.58

  • PROD
    https://sherlocks-office-server.secure.lcl.fr/rs-services/v2/checkout/walletIssuerWalletInitialize
    méthode
    POST
  • TEST
    https://office-server-sherlocks.test.sips-services.com/rs-services/v2/checkout/walletIssuerWalletInitialize
    méthode
    POST
  • PROD
    https://sherlocks-office-server.secure.lcl.fr/services/v2/checkout?wsdl
    méthode
    POST
  • TEST
    https://office-server-sherlocks.test.sips-services.com/services/v2/checkout?wsdl
    méthode
    POST

Obligatoire

Optionnel

Exemple de requête

            {
  "amount": "1000",
  "captureMode": "AUTHOR_CAPTURE",
  "currencyCode": "978",
  "customerIpAddress": "127.0.0.1",
  "interfaceVersion": "IR_WS_2.3",
  "keyVersion": "1",
  "merchantId": "023101122334455",
  "merchantReturnUrl": "http://www.yoursiteweb.com",
  "merchantTransactionDateTime": "2014-07-11T10:59:57.723+02:00",
  "orderChannel": "INTERNET",
  "paymentMeanBrand": "PAYLIB",
  " transactionReference": "TREFEXA2012",
  "merchantWalletId":"12",
  "seal": " 95e479c276d71a07c655f3c2db1bb8b483c0921e544d4af4cff3e220b04eb551"
}

        
                  <urn:walletIssuerWalletInitialize>
         <urn:input>
            <urn:merchantId>011223344550000</urn:merchantId>
            <urn:transactionReference>TREFEXA2012</urn:transactionReference>
            <urn:interfaceVersion>IR_WS_2.2</urn:interfaceVersion>
            <urn:amount>2500</urn:amount>
            <urn:orderChannel>INTERNET</urn:orderChannel>
            <urn:currencyCode>978</urn:currencyCode>
            <urn:paymentMeanBrand>PAYLIB</urn:paymentMeanBrand>
            <urn:merchantReturnUrl>http://www.yoursiteweb.com</urn:merchantReturnUrl>
            <urn:merchantWalletId>12</urn:merchantWalletId>
            <urn:paymentMeanId>3</urn:paymentMeanId>
         </urn:input>
      </urn:walletIssuerWalletInitialize>

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

  • errorFieldName
    présence
    Optionnel
    Interface version
    2.0

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

  • issuerWalletType
    présence
    Optionnel
    Interface version
    2.0

    Identifiant fourni par l’émetteur du wallet pour identifier le moyen de paiement.

    Liste des valeurs
    BCMCMOBILE
    Bancontact Mobile
    MASTERPASS
    Obsolète - Masterpass
    MERCHANT_WALLET
    Wallet Sherlock’s
    PAYLIB
    Paylib
    VISACHECKOUT
    Obsolète - Visa Checkout
  • messageVersion
    présence
    Optionnel
    Interface version
    2.0

    Version des paramètres de redirection.

  • paymentProviderSessionId
    présence
    Optionnel
    Interface version
    2.0

    Identifiant de session calculé lors de l’initialisation d’‘un paiement Sherlock’s In-App ou via un Wallet externe avec Sherlock’s Office.

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

  • responseCode
    présence
    Optionnel
    Interface version
    2.0

    Code réponse du serveur Sherlock’s.

    Liste des valeurs
    00
    Opération acceptée
    01
    Pour les méthodes panToToken et tokenToPan, succès partiel
    02
    Demande d’autorisation par téléphone à la banque à cause d’un dépassement du plafond d’autorisation sur la carte
    03
    Contrat commerçant invalide
    05
    Autorisation refusée
    11
    Utilisé dans le cas d’un contrôle différé. Le PAN est en opposition
    12
    Transaction invalide, vérifier les paramètres transférés dans la requête
    14
    Coordonnées du moyen de paiement invalides (ex : n° de carte ou cryptogramme visuel de la carte) ou vérification AVS échouée
    17
    Annulation de l’acheteur
    24
    • En réponse d’une opération de gestion de caisse : opération impossible. L’opération que vous souhaitez réaliser n’est pas compatible avec l’état de la transaction ou une autre opération de caisse est en cours sur la transaction au même moment.
    • En réponse d’une création de paiement : opération rejetée, requête déjà effectuée avec les mêmes données et les mêmes paramètres
    25
    Transaction inconnue de Sherlock’s
    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
    51
    Montant trop élevé
    54
    Date de validité du moyen de paiement dépassée
    55
    Cartes prépayées non acceptées
    57
    Remboursement refusé car la transaction d’origine a fait l’objet d’un impayé
    60
    Transaction en attente
    62
    En attente de confirmation pour la transaction (utilisé par PayPal 1.0)
    63
    Règles de sécurité non respectées, transaction arrêtée
    75
    Nombre de tentatives de saisie des coordonnées du moyen de paiement sous Sherlock’s Paypage dépassé
    90
    Service temporairement indisponible
    94
    Transaction dupliquée : le transactionReference de la transaction est déjà utilisé
    97
    Session expirée (aucune action de l’utilisateur pendant 15 minutes), transaction refusée
    99
    Problème temporaire du serveur de paiement.

Exemple de réponse

            {
  "responseCode": "00",
  "redirectionUrl": "https://private-payment.test.sips-services.com/paylib/FrontController",
  "redirectionData": "RSs7cZyL1DqsVso",
  "messageVersion": "0.1",
  "seal": "79cf30535e08b8c6c9cfdd55c343845947f8fea892ec0ea1db96378055f71de6"
}

        
                  <walletIssuerWalletInitializeResponse xmlns="urn:sips:cn:contract:office:checkout:v2">
         <output>
            <responseCode>00</responseCode>
            <redirectionUrl>https://private-payment.test.sips-services.com/paylib/FrontController</redirectionUrl>
            <redirectionData>RSs7cZyL1DqsVs...vceJKsC4lg</redirectionData>
            <messageVersion>0.1</messageVersion>
         </output>
      </walletIssuerWalletInitializeResponse>

Changelog


Interface version Donnée Présence Conteneur
2.0 authenticationData Requête
2.37 authentAmount Conteneur
  • authenticationData
    • 2.0 cardAuthPolicy Conteneur
  • authenticationData
    • 2.0 automaticReverse Conteneur
  • cardAuthPolicy
    • 2.0 checkAVS Conteneur
  • cardAuthPolicy
    • 2.0 ignoreAddressCheckResult Conteneur
  • cardAuthPolicy
    • 2.0 ignoreCSCCheckResult Conteneur
  • cardAuthPolicy
    • 2.0 ignorePostcodeCheckResult Conteneur
  • cardAuthPolicy
    • 2.0 billingAddress Requête
    2.0 addressAdditional3 Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 addressAdditional1 Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 addressAdditional2 Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 city Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 company Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 country Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 postBox Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 state Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 street Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 streetNumber Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 zipCode Conteneur
  • billingAddress
  • customerAddress
  • deliveryAddress
  • holderAddress
    • 2.0 billingContact Requête
    2.0 email Conteneur
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 firstname Conteneur
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 gender Conteneur
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.11 initials Conteneur
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 lastname Conteneur
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 mobile Conteneur
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 phone Conteneur
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 title Conteneur
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.23 workPhone Conteneur
  • billingContact
  • customerContact
  • deliveryContact
  • holderContact
    • 2.0 captureDay Requête
    2.0 captureMode Requête
    2.0 customerAddress Requête
    2.0 customerContact Requête
    2.0 customerData Requête
    2.0 birthCity Conteneur
  • customerData
  • holderData
    • 2.0 birthCountry Conteneur
  • customerData
  • holderData
    • 2.0 birthZipCode Conteneur
  • customerData
  • holderData
    • 2.0 birthDate Conteneur
  • customerData
  • holderData
    • 2.51 loyaltyIndicator Conteneur
  • customerData
  • holderData
    • 2.18 maidenName Conteneur
  • customerData
  • holderData
    • 2.0 nationalityCountry Conteneur
  • customerData
  • holderData
    • 2.0 newPassword Conteneur
  • customerData
  • holderData
    • 2.0 password Conteneur
  • customerData
  • holderData
    • 2.0 customerId Requête
    2.0 customerIpAddress Requête
    2.0 customerLanguage Requête
    2.0 deliveryAddress Requête
    2.0 deliveryContact Requête
    2.0 deliveryData Requête
    2.23 deliveryAddressCreationDate Conteneur
  • deliveryData
    • 2.0 deliveryChargeAmount Conteneur
  • deliveryData
    • 2.0 deliveryMethod Conteneur
  • deliveryData
    • 2.0 deliveryMode Conteneur
  • deliveryData
    • 2.0 deliveryOperator Conteneur
  • deliveryData
    • 2.23 electronicDeliveryIndicator Conteneur
  • deliveryData
    • 2.0 estimatedDeliveryDate Conteneur
  • deliveryData
    • 2.0 estimatedDeliveryDelay Conteneur
  • deliveryData
    • 2.0 fraudData Requête
    2.0 allowedIpCountryList Conteneur
  • fraudData
    • 2.0 deniedIpCountryList Conteneur
  • fraudData
    • 2.0 bypass3DS Conteneur
  • fraudData
    • 2.0 bypassCtrlList Conteneur
  • fraudData
    • 2.0 allowedCardArea Conteneur
  • fraudData
    • 2.0 allowedIpArea Conteneur
  • fraudData
    • 2.0 deniedCardArea Conteneur
  • fraudData
    • 2.0 deniedCardCountryList Conteneur
  • fraudData
    • 2.23 challengeMode3DS Conteneur
  • fraudData
    • 2.0 allowedCardCountryList Conteneur
  • fraudData
    • 2.23 addressDeliveryBillingMatchIndicator Conteneur
  • fraudData
    • 2.0 deniedIpArea Conteneur
  • fraudData
    • 2.0 bypassInfoList Conteneur
  • fraudData
    • 2.39 merchantAuthentScoreValue Conteneur
  • fraudData
    • 2.27 merchantCustomerAuthentData Conteneur
  • fraudData
    • 2.27 merchantCustomerAuthentDateTime Conteneur
  • fraudData
    • 2.23 merchantCustomerAuthentMethod Conteneur
  • fraudData
    • 2.23 nameDeliveryCustomerMatchIndicator Conteneur
  • fraudData
    • 2.27 productAvailabilityDate Conteneur
  • fraudData
    • 2.23 productAvailabilityIndicator Conteneur
  • fraudData
    • 2.23 reorderProductIndicator Conteneur
  • fraudData
    • 2.0 riskManagementDynamicSettingList Conteneur
  • fraudData
    • 2.0 riskManagementDynamicSetting Conteneur
  • riskManagementDynamicSettingList
    • 2.0 riskManagementDynamicParam Conteneur
  • riskManagementDynamicSetting
    • 2.0 riskManagementDynamicValue Conteneur
  • riskManagementDynamicSetting
    • 2.0 holderAddress Requête
    2.0 holderContact Requête
    2.0 holderData Requête
    2.0 intermediateServiceProviderId Requête
    2.0 invoiceReference Requête
    2.0 merchantTransactionDateTime Requête
    2.0 orderContext Requête
    2.0 customerBrowserType Conteneur
  • orderContext
    • 2.0 customerANI Conteneur
  • orderContext
    • 2.0 customerANIInformationIdentifier Conteneur
  • orderContext
    • 2.38 merchantOrderSpecificDataList Conteneur
  • orderContext
    • 2.38 merchantOrderSpecificData Conteneur
  • merchantOrderSpecificDataList
    • 2.38 merchantOrderSpecificDataReference Conteneur
  • merchantOrderSpecificData
    • 2.38 merchantOrderSpecificDataType Conteneur
  • merchantOrderSpecificData
    • 2.38 merchantOrderSpecificDataValue Conteneur
  • merchantOrderSpecificData
    • 2.0 customerHostName Conteneur
  • orderContext
    • 2.0 orderId Requête
    2.0 paymentPattern Requête
    2.0 responseKeyVersion Requête
    2.0 returnContext Requête
    2.0 s10TransactionReference Requête
    2.0 s10TransactionId Conteneur
  • s10TransactionReference
    • 2.0 s10TransactionIdDate Conteneur
  • s10TransactionReference
    • 2.0 sealAlgorithm Requête
    2.33 settlementArchivingReference Requête
    2.33 settlementMerchantSpecificData Requête
    2.0 shoppingCartDetail Requête
    2.27 giftCardAmount Conteneur
  • shoppingCartDetail
    • 2.27 giftCardCurrencyCode Conteneur
  • shoppingCartDetail
    • 2.0 mainProduct Conteneur
  • shoppingCartDetail
    • 2.27 giftCardCount Conteneur
  • shoppingCartDetail
    • 2.0 shoppingCartItemList Conteneur
  • shoppingCartDetail
    • 2.0 shoppingCartItem Conteneur
  • shoppingCartItemList
    • 2.0 productName Conteneur
  • shoppingCartItem
    • 2.0 productUnitTaxAmount Conteneur
  • shoppingCartItem
    • 2.0 productDescription Conteneur
  • shoppingCartItem
    • 2.0 productSKU Conteneur
  • shoppingCartItem
    • 2.0 productQuantity Conteneur
  • shoppingCartItem
    • 2.0 productTaxRate Conteneur
  • shoppingCartItem
    • 2.0 productUnitAmount Conteneur
  • shoppingCartItem
    • 2.0 productCode Conteneur
  • shoppingCartItem
    • 2.0 productCategory Conteneur
  • shoppingCartItem
    • 2.0 productTaxCategory Conteneur
  • shoppingCartItem
    • 2.38 travelData Conteneur
  • shoppingCartItem
    • 2.38 travelCardPeriod Conteneur
  • travelData
    • 2.38 journeyDataList Conteneur
  • travelData
    • 2.38 journeyData Conteneur
  • journeyDataList
    • 2.41 journeyAmount Conteneur
  • journeyData
    • 2.38 carrierIdentifier Conteneur
  • journeyData
    • 2.38 classLevel Conteneur
  • journeyData
    • 2.38 departureDateTime Conteneur
  • journeyData
    • 2.38 arrivalLocation Conteneur
  • journeyData
    • 2.38 destinationCountry Conteneur
  • journeyData
    • 2.0 fareBasis Conteneur
  • journeyData
  • travelContext
    • 2.38 carrierName Conteneur
  • journeyData
    • 2.38 journeyCancellableIndicator Conteneur
  • journeyData
    • 2.38 departureLocation Conteneur
  • journeyData
    • 2.38 journeyInsurance Conteneur
  • journeyData
    • 2.38 journeyInsuranceIndicator Conteneur
  • journeyData
    • 2.38 journeyModality Conteneur
  • journeyData
    • 2.38 journeyMode Conteneur
  • journeyData
    • 2.41 journeyNature Conteneur
  • journeyData
    • 2.38 journeySequence Conteneur
  • journeyData
    • 2.38 journeyStage Conteneur
  • journeyData
    • 2.38 luggageSupplementIndicator Conteneur
  • journeyData
    • 2.38 numberOfTickets Conteneur
  • journeyData
    • 2.38 ticketExchangeabilityIndicator Conteneur
  • journeyData
    • 2.38 ticketIssueCity Conteneur
  • journeyData
    • 2.38 ticketIssueDate Conteneur
  • journeyData
    • 2.38 ticketIssuerName Conteneur
  • journeyData
    • 2.38 ticketReference Conteneur
  • journeyData
    • 2.38 stayDataList Conteneur
  • travelData
    • 2.38 stayData Conteneur
  • stayDataList
    • 2.38 stayCategory Conteneur
  • stayData
    • 2.38 numberOfNights Conteneur
  • stayData
    • 2.38 stayCompany Conteneur
  • stayData
    • 2.38 stayArrivalDateTime Conteneur
  • stayData
    • 2.38 numberOfPeopleStaying Conteneur
  • stayData
    • 2.38 roomServiceLevel Conteneur
  • stayData
    • 2.38 stayDepartureDateTime Conteneur
  • stayData
    • 2.38 stayInsurance Conteneur
  • stayData
    • 2.38 stayInsuranceIndicator Conteneur
  • stayData
    • 2.38 stayLocation Conteneur
  • stayData
    • 2.38 stayNumberOfRooms Conteneur
  • stayData
    • 2.38 stayRentalCarIndicator Conteneur
  • stayData
    • 2.38 passportDataList Conteneur
  • travelData
    • 2.38 passportData Conteneur
  • passportDataList
    • 2.38 passportExpirationDate Conteneur
  • passportData
    • 2.38 passportIssueCountry Conteneur
  • passportData
    • 2.46 mainTravelerFirstName Conteneur
  • travelData
    • 2.38 travelCardType Conteneur
  • travelData
    • 2.41 bookingData Conteneur
  • travelData
    • 2.41 bookerFirstName Conteneur
  • bookingData
    • 2.41 bookerLastName Conteneur
  • bookingData
    • 2.41 bookingId Conteneur
  • bookingData
    • 2.41 bookingPlatform Conteneur
  • bookingData
    • 2.41 bookingPlatformOrderId Conteneur
  • bookingData
    • 2.46 mainTravelerLastName Conteneur
  • travelData
    • 2.38 numberOfTravelers Conteneur
  • travelData
    • 2.38 travelEndDateTime Conteneur
  • travelData
    • 2.38 travelingPayerIndicator Conteneur
  • travelData
    • 2.38 travelReason Conteneur
  • travelData
    • 2.38 travelStartDateTime Conteneur
  • travelData
    • 2.0 shoppingCartTotalAmount Conteneur
  • shoppingCartDetail
    • 2.0 shoppingCartTotalQuantity Conteneur
  • shoppingCartDetail
    • 2.0 shoppingCartTotalTaxAmount Conteneur
  • shoppingCartDetail
    • 2.0 statementReference Requête
    2.0 transactionOrigin Requête
    2.0 transactionReference Requête
    2.0 travelContext Requête
    2.0 numberOfRoutingCities Conteneur
  • travelContext
    • 2.0 numberOfAirlineCarriers Conteneur
  • travelContext
    • 2.0 airlineCarrierList Conteneur
  • travelContext
    • 2.0 departureDate Conteneur
  • travelContext
    • 2.0 destinationAirport Conteneur
  • travelContext
    • 2.0 reservationCode Conteneur
  • travelContext
    • 2.0 passengerName Conteneur
  • travelContext
    • 2.0 routingCityList Conteneur
  • travelContext
    • 2.0 originAirport Conteneur
  • travelContext
    • 2.0 numberOfPassengers Conteneur
  • travelContext
    • 2.0 amount Requête
    2.0 currencyCode Requête
    2.0 interfaceVersion Requête
    2.0 keyVersion Requête
    2.0 merchantId Requête
    2.0 merchantReturnUrl Requête
    2.0 merchantWalletId Requête
    2.0 orderChannel Requête
    2.0 paymentMeanId Requête
    2.0 seal Requête/Réponse
    2.0 errorFieldName Réponse
    2.0 issuerWalletType Réponse
    2.0 messageVersion Réponse
    2.0 paymentProviderSessionId Réponse
    2.0 redirectionData Réponse
    2.0 redirectionUrl Réponse
    2.0 responseCode Réponse
    Retourner en haut de page Besoin d'aide ?

    Besoin d'aide ?

    Contacter le support
    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 Sherlock's.
    En fermant ce bandeau vous refusez notre utilisation des traceurs sur votre appareil.

    Paramètres