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.sogenactif.com/rs-services/v2/wallet/getWalletData

méthode

POST
TEST

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

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.
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",
  "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>

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

présence

Optionnel

Interface version

2.0

Format

ANS25 (ISO8601)

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

présence

Optionnel

Interface version

2.0

Format

ANS25 (ISO8601)

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

présence

Optionnel

Interface version

2.0

Format

Composite list

Contient des informations spécifiques sur le moyen de paiement enregistré dans le portefeuille virtuel.
Contient
- 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
    
    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
    
    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
    
    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
    
    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

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

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	`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

getWalletData

Urls des environnements

Requête

Obligatoire

`interfaceVersion`

`keyVersion`

`merchantId`

`merchantWalletId`

`seal`

Optionnel

`intermediateServiceProviderId`

`sealAlgorithm`

Exemple de requête

Réponse

Obligatoire

`seal`

Optionnel

`errorFieldName`

`walletCreationDateTime`

`walletLastActionDateTime`

`walletPaymentMeanDataList`

`walletPaymentMeanData`

`issuerWalletType`

`paymentMeanCoBadgingBrandList`

`paymentMeanBrand`

`maskedPan`

`paymentMeanAlias`

`pspData`

`pspData1`

`paymentMeanId`

`mandateId`

`panExpiryDate`

`transactionActors`

`issuerWalletId`

`walletResponseCode`

Exemple de réponse

Changelog

Besoin d'aide ?