signOff

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

Cette opération permet de supprimer un wallet et les moyens de paiements associés. Si le compte n’existe pas, un code de réponse 01 est retourné. Si la suppression a fonctionné, le code de réponse 00 est retourné avec la date de suppression.

interfaceVersion recommandée : WR_WS_2.53

PROD

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

méthode

POST
TEST

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

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": "SIM01",
  "seal": "8217a6163368bee3b5baebc47a822d40327344ce578411055f95d6e5752d00f4"
}

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

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

présence

Optionnel

Interface version

2.0

Format

ANS25 (ISO8601)

Date / Heure de l’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).
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

            {
  "walletActionDateTime": "2014-05-19T23:20:25-12:00",
  "walletResponseCode": "00",
  "seal": "8ff8b4302b5eeda23bad2d556dd539c2b3991f8dcd4deb66e338df3a1f59ebe6"
}

                  <signOffResponse xmlns="urn:sips:cn:contract:office: wallet:v2">
         <output>
            <walletActionDateTime>2012-10-17T23:50:44-12:00</walletActionDateTime>
            <walletResponseCode>00</walletResponseCode>
            <errorFieldName />
         </output>
      </signOffResponse>

Changelog

Filtre

Interface version	Donnée	Présence
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	`walletActionDateTime`	Réponse
2.0	`walletResponseCode`	Réponse

signOff

Urls des environnements

Requête

Obligatoire

`interfaceVersion`

`keyVersion`

`merchantId`

`merchantWalletId`

`seal`

Optionnel

`intermediateServiceProviderId`

`sealAlgorithm`

Exemple de requête

Réponse

Obligatoire

`seal`

Optionnel

`errorFieldName`

`walletActionDateTime`

`walletResponseCode`

Exemple de réponse

Changelog

Besoin d'aide ?