logo Mercanet

Release 25.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

Avant de lire ce document nous vous conseillons

  • PROD
    https://office-server.mercanet.com/rs-services/v2/walletInApp/walletInitialize
    méthode
    POST
  • TEST
    https://office-server-mercanet.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 Office (M2M) (SOAP/JSON) pour les services d’authentification Mercanet
    AU_WS_2.
    AU_WS: interface Office (M2M) (SOAP/JSON) pour les services de mise à jour de compte Mercanet.
    CR_WS_2.
    interface Office (M2M) (SOAP/JSON) pour les fonctions de gestion de caisse.
    DR_WS_2.
    interface Office (M2M) (SOAP/JSON) pour les fonctions de diagnostique.
    FR_WS_2.
    interface Office (M2M) (SOAP) interface pour les fonctions de fraude.
    HP_x.x
    interface Paypage et Walletpage (POST).
    IR_MB_
    interface In-App (JSON) pour les fonctions In-App.
    IR_WS_
    interface Paypage et Office (M2M) (SOAP/JSON).
    MR_WS_2.
    interface Office (M2M) (SOAP/JSON) pour les fonctions liées aux mandats.
    PMR_WS_2.
    interface Office (M2M) (SOAP/JSON) pour les fonctions de demande d’information sur le référentiel des moyens de paiement.
    ST_WS_2.
    interface Office (M2M) (SOAP/JSON) pour les fonctions scheme token.
    TR_WS_2.
    interface Office (M2M) (SOAP) pour les fonctions de token.
    WMR_WS_2.
    interface Walletpage(SOAP/JSON).
    WR_WS_2.
    interface Office (M2M) (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 Mercanet 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 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 Mercanet pour la phase d’initialisation d’une transaction In-App
    CARDORDER
    Paiement par carte pour la phase d’initialisation d’une transaction In-App
    GETWALLETDATA
    Consultation des informations d’un Wallet Mercanet pour la phase d’initialisation d’une transaction In-App
    PAYMENTPROVIDERORDER
    Paiement via un partenaire externe pour la phase d’initialisation d’une transaction In-App
    PAYMENTTOKENGENERATE
    Génération d’un Token pour une transaction In-App
    THREEDSECUREANDORDER
    Paiement par carte pour la phase d’initialisation d’une transaction In-App avec authentification 3-D Secure
    THREEDSECUREANDWALLETORDER
    Paiement avec un moyen de paiement enregistré dans le Wallet Mercanet pour la phase d’initialisation d’une transaction In-App avec authentification 3-D Secure
    WALLETORDER
    Paiement avec un Wallet Mercanet pour la phase d’initialisation d’une transaction 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 In-App, valeur de la clé publique envoyée par Mercanet au commerçant en réponse de la requête d’initialisation permettant au commerçant de crypter les données carte à envoyer à Mercanet.

  • 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 Mercanet lors d’une redirection (exemple : redirection vers l’ACS, redirection vers le serveur Mercanet). 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