logo Mercanet

Release 24.3

aller directement au contenu

Rechercher par mots clés

getPaymentMeanData

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

Cette fonction permet de consulter un wallet et les informations de ses moyens de paiement.

Si le compte ou le moyen de paiement 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 au moyen de paiement.

interfaceVersion recommandée : WR_WS_2.55

  • PROD
    https://office-server.mercanet.com/rs-services/v2/wallet/getPaymentMeanData
    méthode
    POST
  • TEST
    https://office-server-mercanet.test.sips-services.com/rs-services/v2/wallet/getPaymentMeanData
    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",
  "paymentMeanId": "14",
  "seal": "7ba62b5dc8583a636fa35ec8399025e67d5a6335de4e04e25e99d21209e0bd4e"
}

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

        

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.

  • 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

            {
  "walletResponseCode": "00",
  "walletPaymentMeanData": {
    "paymentMeanId": "14",
    "maskedPan": "4977##########02",
    "paymentMeanBrand": "SEPA_DIRECT_DEBIT"
  },
  "seal": "17f797e25668662aa51d59dbbd51c7094410f46326d15568f73f27621380c34a"
}

        
                  <getPaymentMeanDataResponse xmlns="urn:sips:cn:contract:office:wallet:v2">
         <output>
            <walletResponseCode>00</walletResponseCode>
            <walletPaymentMeanData>
                <paymentMeanId>2</paymentMeanId>
                <maskedPan>5219##########00</maskedPan>
                <paymentMeanAlias>ma carte visa</paymentMeanAlias>
                <panExpiryDate>201306</panExpiryDate>
                <paymenMeanBrand>VISA</paymenMeanBrand>
            </walletPaymentMeanData>
         </output>
      </getPaymentMeanDataResponse>

        

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 paymentMeanId Requête/Réponse
2.0 seal Requête/Réponse
2.0 errorFieldName Réponse
2.0 walletPaymentMeanData Réponse
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.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