Release 24.5

aller directement au contenu

Rechercher par mots clés

walletInitialize

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

Cette fonction permet d’effectuer plusieurs types de cinématiques de gestion du Wallet avec “ (consultation du contenu d’un wallet, ajout et suppression d’une carte dans le wallet).”

interfaceVersion recommandée : IR_MB_3.0

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

Obligatoire

  • interfaceVersion
    présence
    Obligatoire
    Interface version
    1.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
    AR_WS_2.
    Obsolète
    AUT_WS_2.
    interface Sherlock’s Office (SOAP/JSON) pour les services d’authentification Sherlock’s
    AU_WS_2.
    AU_WS: interface Sherlock’s Office (SOAP/JSON) pour les services de mise à jour de compte Sherlock’s.
    CR_WS_2.
    interface Sherlock’s Office (SOAP/JSON) pour les fonctions de gestion de caisse.
    DR_WS_2.
    interface Sherlock’s Office (SOAP/JSON) pour les fonctions de diagnostique.
    FR_WS_2.
    interface Sherlock’s Office (SOAP) interface pour les fonctions de fraude.
    HP_x.x
    interface Sherlock’s Paypage et Sherlock’s Walletpage (POST).
    IR_MB_
    interface Sherlock’s In-App (JSON) pour les fonctions Sherlock’s In-App.
    IR_WS_
    interface Sherlock’s Paypage et Sherlock’s Office (SOAP/JSON).
    MR_WS_2.
    interface Sherlock’s Office (SOAP/JSON) pour les fonctions liées aux mandats.
    PMR_WS_2.
    interface Sherlock’s Office (SOAP/JSON) pour les fonctions de demande d’information sur le référentiel des moyens de paiement.
    TR_WS_2.
    interface Sherlock’s Office (SOAP) pour les fonctions de token.
    WMR_WS_2.
    interface Sherlock’s Walletpage(SOAP/JSON).
    WR_WS_2.
    interface Sherlock’s Office (SOAP/JSON) pour les fonctions liées au wallet.
  • keyVersion
    présence
    Obligatoire
    Interface version
    1.2

    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
    1.0

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

  • merchantWalletId
    présence
    Obligatoire
    Interface version
    1.0

    Identifiant du portefeuille virtuel du client.

  • sdkOperationName
    présence
    Obligatoire
    Interface version
    1.0

    Pour un paiement Sherlock’s In-App (ex : application mobile), indique au moment de la phase d’initialisation, le nom de l’opération qui a été choisie (ex : paiement carte).

    Liste des valeurs
    ADDCARD
    Ajout d’une carte au Wallet Sherlock’s pour la phase d’initialisation d’une transaction Sherlock’s In-App
    CARDORDER
    Paiement par carte pour la phase d’initialisation d’une transaction Sherlock’s In-App
    GETWALLETDATA
    Consultation des informations d’un Wallet Sherlock’s pour la phase d’initialisation d’une transaction Sherlock’s In-App
    PAYMENTPROVIDERORDER
    Paiement via un partenaire externe pour la phase d’initialisation d’une transaction Sherlock’s In-App
    PAYMENTTOKENGENERATE
    Génération d’un Token pour une transaction Sherlock’s In-App
    THREEDSECUREANDORDER
    Paiement par carte pour la phase d’initialisation d’une transaction Sherlock’s In-App avec authentification 3-D Secure
    THREEDSECUREANDWALLETORDER
    Paiement avec un moyen de paiement enregistré dans le Wallet Sherlock’s pour la phase d’initialisation d’une transaction Sherlock’s In-App avec authentification 3-D Secure
    WALLETORDER
    Paiement avec un Wallet Sherlock’s pour la phase d’initialisation d’une transaction Sherlock’s In-App
  • seal
    présence
    Obligatoire
    Interface version
    1.2

    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

            {
  "automaticResponseUrl" : "https://automatic-response-url.fr/",
  "interfaceVersion" : "IR_MB_1.1",
  "keyVersion" : "1",
  "merchantId" : "011223344550000",
  "merchantWalletId" : "walletId01",
  "sdkOperationName" : "GETWALLETDATA",
  "sdkVersion" : "SDK100",
  "seal" : "4e586868b436245140b1fc96c363fd6b211907b4e742c9b4229499e148711288"
}

Obligatoire

  • seal
    présence
    Obligatoire
    Interface version
    1.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

  • publicKeyValue
    présence
    Optionnel
    Interface version
    1.0

    Dans le contexte d’un paiement via Sherlock’s In-App, valeur de la clé publique envoyée par Sherlock’s au commerçant en réponse de la requête d’initialisation permettant au commerçant de crypter les données carte à envoyer à Sherlock’s.

  • redirectionData
    présence
    Optionnel
    Interface version
    1.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.

  • redirectionStatusCode
    présence
    Optionnel
    Interface version
    1.0

    Code réponse retourné par Sherlock’s lors d’une redirection (exemple : redirection vers l’ACS, redirection vers le serveur Sherlock’s). Indique si la redirection est possible ou non.

    Liste des valeurs
    00
    • En retour de paymentWebInit : transaction initialisée
    • En retour de walletCheckEnrollment et cardCheckEnrollment : Carte enrôlée
    01
    En retour de cardCheckEnrollment et walletCheckEnrollment : carte non enrôlée 3-D Secure
    03
    Contrat commerçant invalide
    10
    Enrôlement de la carte n’a pas pu être défini (uniquement en réponse de cardCheckEnrollment et walletCheckEnrollment)
    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)
    30
    Erreur de format (Webinit ERROR)
    34
    Suspicion de fraude, erreur signature (Webinit ERROR)
    80
    Erreur rencontrée lors de l’interrogation du DS
    89
    Session du serveur 3-D Secure expirée
    91
    Commerçant non configuré dans le serveur 3-D Secure
    94
    • En réponse de paymentWebInit : transaction dupliquée. Le transactionReference de la transaction a déjà été utilisé
    • En réponse de cardCheckEnrollment ou walletCheckEnrollment : erreur pendant la vérification de l’enrôlement
    99
    Erreur interne
  • redirectionStatusMessage
    présence
    Optionnel
    Interface version
    1.0

    Information complémentaire retournée en plus du redirectionStatusCode.

  • redirectionUrl
    présence
    Optionnel
    Interface version
    1.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.

  • redirectionVersion
    présence
    Optionnel
    Interface version
    1.0

    Version du message de redirection.

Exemple de réponse

            {
  "publicKeyValue":"30820122...10001",
  "redirectionData":"4AgbsrffvP...1_H2YKez1ncQ",
  "redirectionStatusCode":"00",
  "redirectionStatusMessage":"OneClick available for provided merchant",
  "redirectionUrl":"https://office-server.sips-services.com/rs-api/public/v2/walletInApp/getWalletData",
  "redirectionVersion":"IR_MB_1.1",
  "seal":"2cbb1daf03059d015e8523ca3e270a36a0614bbe172178c8b3b7cdf53ea7a5fc"
}

Changelog


Interface version Donnée Présence Conteneur
1.0 automaticResponseUrl Requête
1.2 intermediateServiceProviderId Requête
1.0 responseKeyVersion Requête
1.0 sdkVersion Requête
1.2 sealAlgorithm Requête
2.42 subMerchantAddress Requête
2.42 streetNumber Conteneur
  • subMerchantAddress
    • 2.42 addressAdditional3 Conteneur
  • subMerchantAddress
    • 2.42 country Conteneur
  • subMerchantAddress
    • 2.42 state Conteneur
  • subMerchantAddress
    • 2.42 postBox Conteneur
  • subMerchantAddress
    • 2.42 city Conteneur
  • subMerchantAddress
    • 2.42 company Conteneur
  • subMerchantAddress
    • 2.42 street Conteneur
  • subMerchantAddress
    • 2.42 addressAdditional1 Conteneur
  • subMerchantAddress
    • 2.42 addressAdditional2 Conteneur
  • subMerchantAddress
    • 2.42 zipCode Conteneur
  • subMerchantAddress
    • 2.42 subMerchantCategoryCode Requête
    2.42 subMerchantId Requête
    2.42 subMerchantLegalId Requête
    2.42 subMerchantName Requête
    2.42 subMerchantUrl Requête
    1.0 interfaceVersion Requête
    1.2 keyVersion Requête
    1.0 merchantId Requête
    1.0 merchantWalletId Requête
    1.0 sdkOperationName Requête
    1.2 seal Requête/Réponse
    1.0 publicKeyValue Réponse
    1.0 redirectionData Réponse
    1.0 redirectionStatusCode Réponse
    1.0 redirectionStatusMessage Réponse
    1.0 redirectionUrl Réponse
    1.0 redirectionVersion 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