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