S-money API

Callbacks management

Hadassa — 2017-04-28T17:02:29Z

2.1 Method to create the signature

CallbackSignature is a computed and encrypted chain enabling the client to verify the validity of the call.

It is built as follows:
Extracting all callback parameters (except CallbackSignature)
Classifying by alphabetical order (ascendant) and by key
Extracting their values to a list
Adding the client secret chain to this list (in pre-production by the value "0")
concatenation of these values into a unique chain via the sign "+"
Verifying the chain is in the UTF-8 format
Hashing the chain via the "SHA-1" algorithm
Attributing the result to the parameter "CallbackSignature".

2.2 Method to verify the callbacks validity

To verify a request is valid, you first have to create a signature with the construction method and compare this signature value to the value of the signature received in the callback.
If both signatures are similar, then the request is valid. If not, the request has been corrupted..

2.3 EXAMPLE OF A SIGNATURE COMPUTATION

Example 1 : Callback valid

orderId=123456amount=1020&CallbackSignature=814de6e4d24008b1764fe093026b5127cddbf6c2

Concatenated chain (with secret chain = 0) : 1020+123456+0

CallbackSignature computed : 814de6e4d24008b1764fe093026b5127cddbf6c2

Example 2 : Callback corrupted

orderId=123456&amount=1020&CallbackSignature=c7ce2c2adb001127d2c2a12612184669f340dfd7

Concatenated chain (with secret chain = 0) : 1020+123456+0

CallbackSignature computed : 814de6e4d24008b1764fe093026b5127cddbf6c2

Prerequisite

Hadassa — 2017-04-28T17:02:00Z

Please ask S-money team to activate this functionality. Once confirmed, a new parameter "CallbackSignature" will be added to callbacks contents.

- V1

Gestion des callbacks

Hadassa — 2016-09-22T15:20:05Z

2.1 Méthode de construction de la signature

CallbackSignature est une chaîne calculée et cryptée qui permet au client de vérifier la validité de l'appel.

Elle est construite comme suit :
Extraction de tous les paramètres du callback (hors CallbackSignature)
Classement par ordre alphabétique (ascendant) et par clé
Extraction de leurs valeurs vers une liste
Ajout de la chaîne secrète du client à cette liste (en preproduction par la valeur « 0 »)
Concaténation de ces valeurs en une chaîne unique via le symbole « + »
Vérification que la chaîne est au format UTF-8
Hashage de la chaîne via l'algorithme « SHA-1 »
Attribution du résultat au paramètre « CallbackSignature ».

2.2 Méthode de vérification de validité des callbacks

Pour vérifier qu'une requête est valide, il faut d'abord générer une signature selon la méthode construction et effectuer une comparaison de la valeur de la signature généré et la valeur de la signature reçue dans le callback.
Si les deux signatures sont similaires, alors la requête est valide. Sinon, la requête a été corrompue.

2.3 EXEMPLE DE CALCUL DE SIGNATURE

Exemple 1 : Callback valide

orderId=123456amount=1020&CallbackSignature=814de6e4d24008b1764fe093026b5127cddbf6c2

Chaine concaténée (avec chaine secrète = 0) : 1020+123456+0

CallbackSignature calculé : 814de6e4d24008b1764fe093026b5127cddbf6c2

Exemple 2 : Callback corrompu

orderId=123456&amount=1020&CallbackSignature=c7ce2c2adb001127d2c2a12612184669f340dfd7

Chaine concaténée (avec chaine secrète = 0) : 1020+123456+0

CallbackSignature calculé : 814de6e4d24008b1764fe093026b5127cddbf6c2

Prérequis

Hadassa — 2016-09-22T15:20:03Z

Avoir sollicité l'équipe S-money pour l'activation de cette fonctionnalité. Une fois confirmé, un nouveau paramètre « CallbackSignature » sera ajouté aux contenus des callbacks.

- V1