logo Mercanet

Release 24.3

aller directement au contenu

Rechercher par mots clés

getWalletData

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

Cette opération permet de consulter un wallet et les moyens de paiement associés.

Si le compte n’existe pas, un code de réponse 01 est retourné. Si la requête a réussi, le code de réponse 00 est retourné, ainsi que les informations relatives aux moyens de paiement.

interfaceVersion recommandée : WR_WS_2.55

  • PROD
    https://office-server.mercanet.com/rs-services/v2/wallet/getWalletData
    méthode
    POST
  • TEST
    https://office-server-mercanet.test.sips-services.com/rs-services/v2/wallet/getWalletData
    méthode
    POST
  • PROD
    https://office-server.mercanet.com/services/v2/wallet?wsdl
    méthode
    POST
  • TEST
    https://office-server-mercanet.test.sips-services.com/services/v2/wallet?wsdl
    méthode
    POST

Obligatoire

Optionnel

Exemple de requête

            {
  "interfaceVersion": " WR_WS_2.3",
  "keyVersion": "1",
  "merchantId": "011223344550000",
  "merchantWalletId": " walId011",
  "seal": "8217a6163368bee3b5baebc47a822d40327344ce578411055f95d6e5752d00f4"
}

        
                  <urn:getWalletData>
         <urn:input>
            <urn:merchantId>011223344550000</urn:merchantId>
            <urn:interfaceVersion>WR_WS_2.2</urn:interfaceVersion>
            <urn:merchantWalletId>walId011</urn:merchantWalletId>
         </urn:input>
      </urn:getWalletData>

        

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.

  • walletCreationDateTime
    présence
    Optionnel
    Interface version
    2.0

    Date / Heure de l’enregistrement du moyen de paiement dans le portefeuille virtuel, enregistrées dans le système Mercanet à l’heure locale du commerçant (dans le fuseau horaire du commerçant).

  • walletLastActionDateTime
    présence
    Optionnel
    Interface version
    2.0

    Date / Heure de la dernière action sur le portefeuille virtuel, enregistrées dans le système Mercanet à l’heure locale du commerçant (dans le fuseau horaire du commerçant).

  • walletPaymentMeanDataList
    présence
    Optionnel
    Interface version
    2.0

    Contient des informations spécifiques sur le moyen de paiement enregistré dans le portefeuille virtuel.

    Contient
    • walletPaymentMeanData
      présence
      Optionnel
      Interface version
      2.0

      Contient des informations spécifiques sur le moyen de paiement enregistré dans le portefeuille virtuel.

      Contient
      • issuerWalletType
        présence
        Optionnel
        Interface version
        2.23

        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 Mercanet
        PAYLIB
        Paylib
        VISACHECKOUT
        Obsolète - Visa Checkout
      • paymentMeanCoBadgingBrandList
        présence
        Optionnel
        Interface version
        2.36

        Liste des marques d’une carte enregistrée dans un wallet.

        Liste des valeurs
        1EUROCOM
        Cofidis Pay 5x10x20x paymentMeanBrandType : ONLINE_CREDIT
        3XCBCOFINOGA
        Valeur Obsolète. Cofinoga 3xCB paymentMeanBrandType : CARD
        ACCEPTGIRO
        AcceptGiro paymentMeanBrandType : CREDIT_TRANSFER
        ACCORD_3X
        Facily Pay Paiement 3 fois paymentMeanBrandType : ONLINE_CREDIT
        ACCORD_4X
        Facily Pay Paiement 4 fois paymentMeanBrandType : ONLINE_CREDIT
        AIRPLUS
        Carte Airplus paymentMeanBrandType : CARD
        AIRPLUS_LOGEE
        Carte Airplus logée paymentMeanBrandType : CARD
        AMEX
        Carte American Express paymentMeanBrandType : CARD
        AMEX_LOGEE
        Carte American Express logée paymentMeanBrandType : CARD
        AURORE
        Carte CPAY paymentMeanBrandType : CARD
        BCACB_3X
        Floa Bank CB paiement en 3 fois paymentMeanBrandType : ONLINE_CREDIT
        BCACB_4X
        Floa Bank CB paiement en 4 fois paymentMeanBrandType : ONLINE_CREDIT
        BCACUP
        Carte CUP de Floa Bank paymentMeanBrandType : CARD
        BCMC
        Bancontact paymentMeanBrandType : CARD
        CACF_3X
        CACF paiement en 3 fois paymentMeanBrandType : ONLINE_CREDIT
        CACF_4X
        CACF paiement en 4 fois paymentMeanBrandType : ONLINE_CREDIT
        CADHOC
        Cadhoc paymentMeanBrandType : CARD
        CADOCARTE
        Cado Carte paymentMeanBrandType : CARD
        CB
        Carte Bancaire paymentMeanBrandType : CARD
        CETELEM_3X
        Cetelem 3xCB paymentMeanBrandType : ONLINE_CREDIT
        CETELEM_4X
        Cetelem 4xCB paymentMeanBrandType : ONLINE_CREDIT
        COFIDIS_3X
        Cofidis 3xCB paymentMeanBrandType : ONLINE_CREDIT
        COFIDIS_4X
        Cofidis 4xCB paymentMeanBrandType : ONLINE_CREDIT
        CONECS
        Titres Restaurants Dématérialisés Conecs paymentMeanBrandType : VOUCHER
        CUP
        Carte China UnionPay paymentMeanBrandType : CARD
        CVA
        Carte Visa Aurore paymentMeanBrandType : CARD
        CVCO
        Chèque-Vacances Connect paymentMeanBrandType : VOUCHER
        DINERS
        Carte Diners club international paymentMeanBrandType : CARD
        FRANFINANCE_3X
        Franfinance 3xCB paymentMeanBrandType : ONLINE_CREDIT
        FRANFINANCE_4X
        Franfinance 4xCB paymentMeanBrandType : ONLINE_CREDIT
        GIROPAY
        Giropay paymentMeanBrandType : CREDIT_TRANSFER
        ILLICADO
        Illicado paymentMeanBrandType : CARD
        INCASSO
        Incasso paymentMeanBrandType : DIRECT_DEBIT
        INGHOMEPAY
        PayButton ING Home’Pay paymentMeanBrandType : CREDIT_TRANSFER
        JCB
        Carte Japan Credit Bureau paymentMeanBrandType : CARD
        LEPOTCOMMUN
        Le Pot Commun paymentMeanBrandType : CARD
        LYDIA
        Lydia paymentMeanBrandType : PROVIDER
        MAESTRO
        Carte Maestro (Mastercard) paymentMeanBrandType : CARD
        MASTERCARD
        Carte Mastercard paymentMeanBrandType : CARD
        MASTERPASS
        Obsolète - Portefeuille virtuel MasterPass paymentMeanBrandType : WALLET
        ONEY34X
        Oney Paiement 3 fois ou 4 fois paymentMeanBrandType : ONLINE_CREDIT
        PAYLIB
        Portefeuille virtuel Paylib paymentMeanBrandType : WALLET
        PAYPAL
        Paypal paymentMeanBrandType : WALLET
        PAYTRAIL
        Paytrail paymentMeanBrandType : CREDIT_TRANSFER
        PAY_BY_BANK
        Virement bancaire SEPA paymentMeanBrandType : CREDIT_TRANSFER
        SEPA_DIRECT_DEBIT
        SDD (SEPA Direct Debit) paymentMeanBrandType : DIRECT_DEBIT
        SOFINCO
        Carte Sofinco paymentMeanBrandType : CARD
        SOFORTUBERWEISUNG
        Sofortüberweisung (Sofort Banking) paymentMeanBrandType : CREDIT_TRANSFER
        UNKNOWN
        Inconnu
        VISA
        Carte Visa paymentMeanBrandType : CARD
        VISACHECKOUT
        Obsolète - Portefeuille virtuel Visa Checkout paymentMeanBrandType : WALLET
        VISA_ELECTRON
        Carte Visa Electron paymentMeanBrandType : CARD
        VPAY
        Carte VPAY (Visa) paymentMeanBrandType : CARD
      • paymentMeanBrand
        présence
        Optionnel
        Interface version
        2.0

        Nom du moyen de paiement utilisé. Il est lié à un paymentMeanType.

        Liste des valeurs
        1EUROCOM
        Cofidis Pay 5x10x20x Contrat d’acquisition : ONLINE_CREDIT
        3XCBCOFINOGA
        Valeur Obsolète. Cofinoga 3xCB paymentMeanBrandType : CARD
        ACCEPTGIRO
        AcceptGiro paymentMeanBrandType : CREDIT_TRANSFER
        AIRPLUS
        Carte Airplus paymentMeanBrandType : CARD
        AIRPLUS_LOGEE
        Carte Airplus logée paymentMeanBrandType : CARD
        AMEX
        Carte American Express paymentMeanBrandType : CARD
        AMEX_LOGEE
        Carte American Express logée paymentMeanBrandType : CARD
        AURORE
        Carte CPAY paymentMeanBrandType : CARD
        BCACB_3X
        Floa Bank CB paiement en 3 fois paymentMeanBrandType : ONLINE_CREDIT
        BCACB_4X
        Floa Bank CB paiement en 4 fois paymentMeanBrandType : ONLINE_CREDIT
        BCACUP
        Carte CUP de Floa Bank paymentMeanBrandType : CARD
        BCMC
        Bancontact paymentMeanBrandType : CARD
        CACF_3X
        CACF paiement en 3 fois paymentMeanBrandType : ONLINE_CREDIT
        CACF_3XSANSFRAIS
        CACF paiement en 3 fois sans frais paymentMeanBrandType : ONLINE_CREDIT
        CACF_4X
        CACF paiement en 4 fois paymentMeanBrandType : ONLINE_CREDIT
        CACF_4XSANSFRAIS
        CACF paiement en 4 fois sans frais paymentMeanBrandType : ONLINE_CREDIT
        CADHOC
        Cadhoc paymentMeanBrandType : CARD
        CADOCARTE
        Cado Carte paymentMeanBrandType : CARD
        CB
        Carte Bancaire paymentMeanBrandType : CARD
        CETELEM_3X
        Cetelem 3xCB paymentMeanBrandType : ONLINE_CREDIT
        CETELEM_4X
        Cetelem 4xCB paymentMeanBrandType : ONLINE_CREDIT
        COFIDIS_3X
        Cofidis 3xCB paymentMeanBrandType : ONLINE_CREDIT
        COFIDIS_4X
        Cofidis 4xCB paymentMeanBrandType : ONLINE_CREDIT
        CONECS
        Titres Restaurants Dématérialisés Conecs paymentMeanBrandType : VOUCHER
        CUP
        Carte China UnionPay paymentMeanBrandType : CARD
        CVA
        Carte Visa Aurore paymentMeanBrandType : CARD
        CVCO
        Chèque-Vacances Connect paymentMeanBrandType : VOUCHER
        DINERS
        Carte Diners club international paymentMeanBrandType : CARD
        FRANFINANCE_3X
        Franfinance 3xCB paymentMeanBrandType : ONLINE_CREDIT
        FRANFINANCE_4X
        Franfinance 4xCB paymentMeanBrandType : ONLINE_CREDIT
        GIROPAY
        Giropay paymentMeanBrandType : CREDIT_TRANSFER
        ILLICADO
        Illicado paymentMeanBrandType : CARD
        INCASSO
        Incasso paymentMeanBrandType : DIRECT_DEBIT
        INGHOMEPAY
        PayButton ING Home’Pay paymentMeanBrandType : CREDIT_TRANSFER
        JCB
        Carte Japan Credit Bureau paymentMeanBrandType : CARD
        LEPOTCOMMUN
        Le Pot Commun paymentMeanBrandType : CARD
        LYDIA
        Lydia paymentMeanBrandType : PROVIDER
        MAESTRO
        Carte Maestro (Mastercard) paymentMeanBrandType : CARD
        MASTERCARD
        Carte Mastercard paymentMeanBrandType : CARD
        MASTERPASS
        Obsolète - Portefeuille virtuel MasterPass paymentMeanBrandType :
        ONEY34X
        Oney Paiement 3 fois ou 4 fois paymentMeanBrandType : ONLINE_CREDIT
        PAYLIB
        Portefeuille virtuel Paylib paymentMeanBrandType :
        PAYPAL
        Paypal paymentMeanBrandType : WALLET
        PAYTRAIL
        Paytrail paymentMeanBrandType : CREDIT_TRANSFER
        PAY_BY_BANK
        Virement bancaire SEPA paymentMeanBrandType : CREDIT_TRANSFER
        SEPA_DIRECT_DEBIT
        SDD (SEPA Direct Debit) paymentMeanBrandType : DIRECT_DEBIT
        SOFINCO
        Carte Sofinco paymentMeanBrandType : CARD
        SOFORTUBERWEISUNG
        Sofortüberweisung (Sofort Banking) paymentMeanBrandType : CREDIT_TRANSFER
        UNKNOWN
        Moyen de paiement inconnu (cette valeur peut être retournée par Mercanet mais ne doit pas être utilisée dans une requête)
        VISA
        Carte Visa paymentMeanBrandType : CARD
        VISACHECKOUT
        Obsolète - Portefeuille virtuel Visa Checkout paymentMeanBrandType : WALLET
        VISA_ELECTRON
        Carte Visa Electron paymentMeanBrandType : CARD
        VPAY
        Carte VPAY (Visa) paymentMeanBrandType : CARD
      • maskedPan
        présence
        Optionnel
        Interface version
        2.0

        Numéro de PAN masqué. Dans le cas des portefeuilles virtuels, correspond au numéro de PAN masqué du moyen de paiement enregistré dans le portefeuille virtuel.

      • paymentMeanAlias
        présence
        Optionnel
        Interface version
        2.0

        Alias du moyen de paiement défini par l’acheteur et utilisé dans son portefeuille virtuel.

        Attention : utiliser ce champ libre uniquement pour l’usage prévu, et par conséquent ne pas y insérer des données à caractère personnel, et plus particulièrement des données de porteur de carte. En cas de non-respect de cette consigne BNP Paribas ne serait être tenu responsable d’un point de vu légal, de tout incident qui pourrait survenir.

        En tant que sous-traitant, BNP Paribas traite les données à caractère personnel conformément aux Conditions de Traitement des Données à Caractère Personnel (CTDCP), annexées à tous les contrats.

        Ainsi :

        • Les données personnelles prévues par le CTDCP doivent uniquement être transmises à BNP Paribas au travers des champs prévus à cet effet (cf. dictionnaire des données).
        • Toutes autres données à caractère personnel non listées dans le CTDCP ne doivent pas être transmises à BNP Paribas
      • pspData
        présence
        Optionnel
        Interface version
        2.15

        Pour usage futur.Données privées du Psp.

        Contient
      • paymentMeanId
        présence
        Optionnel
        Interface version
        2.0

        Rang du moyen de paiement au sein du wallet Mercanet.

      • mandateId
        présence
        Optionnel
        Interface version
        2.18

        Numéro de mandat.

      • panExpiryDate
        présence
        Optionnel
        Interface version
        2.0

        Date d’expiration d’un support associé à un Primary Account Number.Par exemple, pour une carte, contient la date de validité pour une opération de demande d’autorisation. Si le moyen de paiement ne possède pas de date de validité, ce champ doit être vide.

      • transactionActors
        présence
        Optionnel
        Interface version
        2.0

        Indique les acteurs de la transaction.

        Liste des valeurs
        BTOB
        Professionnel à Professionnel
        BTOC
        Professionnel à Particulier
        BTOF
        Professionnel à organisation / association
      • issuerWalletId
        présence
        Optionnel
        Interface version
        2.23

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

  • walletResponseCode
    présence
    Optionnel
    Interface version
    2.0

    Code réponse du serveur Mercanet pour la gestion du portefeuille virtuel.

    Liste des valeurs
    00
    Opération réalisée avec succès
    03
    Marchand inconnu / le marchand n’a pas de groupId configuré
    12
    Données invalides, vérifiez la requête
    25
    Wallet/Moyen de paiement inconnu
    30
    Erreur de format
    40
    Le marchandId n’a pas l’option wallet
    94
    Wallet/Moyen de paiement dupliqué
    99
    Problème temporaire au niveau du serveur Mercanet

Exemple de réponse

            {
  "walletCreationDateTime": "2013-12-23T05:17:26-12:00",
  "walletLastActionDateTime": "2014-01-19T23:16:00-12:00",
  "walletResponseCode": "00",
  "walletPaymentMeanDataList": [
    {
      "paymentMeanId": "14",
      "maskedPan": "4977##########02",
      "paymentMeanBrand": "SEPA_DIRECT_DEBIT"
    },
    {
      "paymentMeanId": "13",
      "maskedPan": "4977##########55",
      "paymentMeanAlias": "MySDD",
      "panExpiryDate": "201501",
      "paymentMeanBrand": "CB"
    }
  ],
  "seal": "4579cfc4044c29550327f9cba0be400129e95cb5b2639c6e301484930b4f9f94"
}

        
                  <getWalletDataResponse xmlns="urn:sips:cn:contract:office:wallet:v2">
         <output>
            <walletCreationDateTime>2012-10-17T23:50:44-12:00</walletActionDateTime>
            <walletLastActionDateTime>2013-10-17T23:50:44-12:00</walletLastActionDateTime>
            <walletResponseCode>00</walletResponseCode>
            < walletPaymentMeanDataList>
               <walletPaymentMeanData>
                   <paymentMeanId>2</paymentMeanId>
                   <maskedPan>5219##########00</maskedPan>
                   <paymentMeanAlias>ma carte visa</paymentMeanAlias>
                   <panExpiryDate>201306</panExpiryDate>
                   <paymenMeanBrand>VISA</paymenMeanBrand>
               </walletPaymentMeanData>
            </walletPaymentMeanDataList>
         </output>
      </getWalletDataResponse>

        

Changelog


Interface version Donnée Présence Conteneur
2.12 intermediateServiceProviderId Requête
2.12 sealAlgorithm Requête
2.0 interfaceVersion Requête
2.0 keyVersion Requête
2.0 merchantId Requête
2.0 merchantWalletId Requête
2.0 seal Requête/Réponse
2.0 errorFieldName Réponse
2.0 walletCreationDateTime Réponse
2.0 walletLastActionDateTime Réponse
2.0 walletPaymentMeanDataList Réponse
2.0 walletPaymentMeanData Conteneur
  • walletPaymentMeanDataList
  • 2.23 issuerWalletType Conteneur
  • walletPaymentMeanData
  • 2.36 paymentMeanCoBadgingBrandList Conteneur
  • walletPaymentMeanData
  • 2.0 paymentMeanBrand Conteneur
  • walletPaymentMeanData
  • 2.0 maskedPan Conteneur
  • walletPaymentMeanData
  • 2.0 paymentMeanAlias Conteneur
  • walletPaymentMeanData
  • 2.15 pspData Conteneur
  • walletPaymentMeanData
  • 2.15 pspData1 Conteneur
  • pspData
  • 2.0 paymentMeanId Conteneur
  • walletPaymentMeanData
  • 2.18 mandateId Conteneur
  • walletPaymentMeanData
  • 2.0 panExpiryDate Conteneur
  • walletPaymentMeanData
  • 2.0 transactionActors Conteneur
  • walletPaymentMeanData
  • 2.23 issuerWalletId Conteneur
  • walletPaymentMeanData
  • 2.0 walletResponseCode Réponse
    Retourner en haut de page Besoin d'aide ?

    Besoin d'aide ?

    Fermer