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

PROD

https://office-server.sogenactif.com/rs-services/v2/wallet/getPaymentMeanData

méthode

POST
TEST

https://office-server-sogenactif.test.sips-services.com/rs-services/v2/wallet/getPaymentMeanData

méthode

POST

PROD

https://office-server.sogenactif.com/services/v2/wallet?wsdl

méthode

POST
TEST

https://office-server-sogenactif.test.sips-services.com/services/v2/wallet?wsdl

méthode

POST

Requête

Obligatoire

interfaceVersion
présence

Obligatoire

Interface version

2.0
Format
AN20(restricted String)
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

WR_WS_2.

interface Sogenactif Office Serveur (SOAP/JSON) pour les fonctions liées au wallet.
keyVersion

présence

Obligatoire

Interface version

2.0

Format

N10

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

2.0

Format

N15

Identifiant de la boutique, sa valeur est fournie par Sogenactif au commerçant lors de l’inscription de sa boutique.
merchantWalletId
présence

Obligatoire

Interface version

2.0
Format
AN21(restricted String)
Identifiant du portefeuille virtuel du client.
paymentMeanId

présence

Obligatoire

Interface version

2.0

Format

N6

Rang du moyen de paiement au sein du wallet Sogenactif.
seal

présence

Obligatoire

Interface version

2.0

Format

ANS128

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

intermediateServiceProviderId

présence

Optionnel

Interface version

2.12

Format

AN30

Identifiant du service utilisé par le commerçant pour les échanges de flux avec la plateforme Sogenactif.
sealAlgorithm

présence

Optionnel

Interface version

2.12

Format

ANS20(restricted values)

Algorithme de cryptage utilisé pour le calcul du sceau.

Liste des valeurs

HMAC-SHA-256

L’algorithme de cryptage utilisé est HMAC-SHA-256

HMAC-SHA-512

L’algorithme de cryptage utilisé est HMAC-SHA-512

SHA-256

L’algorithme de cryptage utilisé est SHA-256

Exemple de requête

json
soap

            {
  "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>

Réponse

Obligatoire

seal

présence

Obligatoire

Interface version

2.0

Format

ANS128

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

Format

ANS50

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

présence

Optionnel

Interface version

2.0

Format

Container

Contient des informations spécifiques sur le moyen de paiement enregistré dans le portefeuille virtuel.
Contient
- issuerWalletType
  
  présence
  
  Optionnel
  
  Interface version
  
  2.23
  
  Format
  
  ANS20(restricted values)
  
  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 Sogenactif
  
  PAYLIB
  
  Paylib
  
  VISACHECKOUT
  
  Obsolète - Visa Checkout
- paymentMeanCoBadgingBrandList
  
  présence
  
  Optionnel
  
  Interface version
  
  2.36
  
  Format
  
  ANS128(list)
  
  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
  
  ELV
  
  Elektronisches LastschriftVerfahren paymentMeanBrandType : DIRECT_DEBIT
  
  FIVORY
  
  Lyf Pay paymentMeanBrandType : WALLET
  
  FRANFINANCE_3X
  
  Franfinance 3xCB paymentMeanBrandType : ONLINE_CREDIT
  
  FRANFINANCE_4X
  
  Franfinance 4xCB paymentMeanBrandType : ONLINE_CREDIT
  
  GIROPAY
  
  Giropay paymentMeanBrandType : CREDIT_TRANSFER
  
  IDEAL
  
  iDeal 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
  
  PRESTO
  
  Presto Plus paymentMeanBrandType : ONLINE_CREDIT
  
  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
  
  Format
  
  ANS20(restricted values)
  
  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
  
  ELV
  
  Elektronisches LastschriftVerfahren paymentMeanBrandType : DIRECT_DEBIT
  
  FIVORY
  
  Lyf Pay paymentMeanBrandType : WALLET
  
  FRANFINANCE_3X
  
  Franfinance 3xCB paymentMeanBrandType : ONLINE_CREDIT
  
  FRANFINANCE_4X
  
  Franfinance 4xCB paymentMeanBrandType : ONLINE_CREDIT
  
  GIROPAY
  
  Giropay paymentMeanBrandType : CREDIT_TRANSFER
  
  IDEAL
  
  iDeal 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
  
  PRESTO
  
  Presto Plus paymentMeanBrandType : ONLINE_CREDIT
  
  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 Sogenactif 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
  
  Format
  
  NS19
  
  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
  Format
  
  ANU20(restricted String)
  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 SG ne serait être tenu responsable d’un point de vu légal, de tout incident qui pourrait survenir.
  
  En tant que sous-traitant, SG 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 à SG 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 à SG
- pspData
  
  présence
  
  Optionnel
  
  Interface version
  
  2.15
  
  Format
  
  ANS255
  
  Pour usage futur.Données privées du Psp.
  Contient
  - pspData1
    
    présence
    
    Optionnel
    
    Interface version
    
    2.15
    
    Format
    
    ANS255
    
    Pour usage futur.Données privées du Psp.
- paymentMeanId
  
  présence
  
  Optionnel
  
  Interface version
  
  2.0
  
  Format
  
  N6
  
  Rang du moyen de paiement au sein du wallet Sogenactif.
- mandateId
  
  présence
  
  Optionnel
  
  Interface version
  
  2.18
  
  Format
  
  AN35
  
  Numéro de mandat.
- panExpiryDate
  
  présence
  
  Optionnel
  
  Interface version
  
  2.0
  
  Format
  
  N6(YYYYMM)
  
  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
  
  Format
  
  A4(restricted values)
  
  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
  Format
  
  ANS50 (restricted string)
  Identifiant fourni par l’émetteur du wallet pour identifier le moyen de paiement.
walletResponseCode

présence

Optionnel

Interface version

2.0

Format

N2(restricted values)

Code réponse du serveur Sogenactif 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 Sogenactif

Exemple de réponse

json
soap

            {
  "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

Filtre

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

getPaymentMeanData

Urls des environnements

Requête

Obligatoire

`interfaceVersion`

`keyVersion`

`merchantId`

`merchantWalletId`

`paymentMeanId`

`seal`

Optionnel

`intermediateServiceProviderId`

`sealAlgorithm`

Exemple de requête

Réponse

Obligatoire

`seal`

Optionnel

`errorFieldName`

`walletPaymentMeanData`

`issuerWalletType`

`paymentMeanCoBadgingBrandList`

`paymentMeanBrand`

`maskedPan`

`paymentMeanAlias`

`pspData`

`pspData1`

`paymentMeanId`

`mandateId`

`panExpiryDate`

`transactionActors`

`issuerWalletId`

`walletResponseCode`

Exemple de réponse

Changelog

Besoin d'aide ?