V1

Enregistrer une carte bancaire

2.1 Envoi des données de la requête d’enregistrement carte au serveur S-money

Pour ajouter une carte bancaire, les paramètres obligatoires sont les suivants :
- card
- appcardid
- urlReturn

Les autres paramètres sont optionnels.

Veuillez vous référer à l’exemple présent en marge de droite de cette page, pour l’enregistrement d’une carte bancaire d’un utilisateur.

Le paramètre "href" contient l’url vers laquelle l’application tierce doit rediriger le navigateur client pour effectuer l’enregistrement de la carte.

2.2 Envoie des données de l’enregistrement carte au serveur tiers

Le serveur tiers doit mettre à disposition une url serveur permettant au serveur S-money de le notifier du résultat de l’exécution du paiement.

L’appel du serveur S-money est effectué en méthode HTTP POST.

Les paramètres de la requête HTTP sont :

Paramètre Type Description
id Long Id de la carte
error Int Code d’erreur pour les renseignements carte échoués, 0 si aucune erreur.
1 = Le commerçant doit contacter la banque du porteur
2 = Paiement refusé
3 = Paiement annulé par le client
4 = Porteur non enrôlé 3D-Secure
5 = Erreur authentification 3D-Secure
6 = Erreur technique SystemPay
type Int Type de l’opération
5 =enregistrement carte
userid String Identifiant de l’utilisateur chez l’application tierce

2.3 Redirection en fin d’enregistrement carte

Le serveur tiers doit mettre à disposition une url permettant au serveur S-money de rediriger le client vers l’environnement tiers.

L’url peut-être soit associée au scheme web (http/https) ou à un scheme privatif dans le cas où l’appel serait effectué à partir d’une application mobile tierce.

L’appel du serveur S-money est effectué en méthode HTTP POST.
Les paramètres de la requête HTTP sont :

Paramètre Type Description
Id Long Id de la carte bancaire
Type Int Type de l’opération
5 = enregistrement carte
Result Int Statut de la transaction
0 = Erreur
1 = OK