Top-up by cheque

Généralités

1.1 Principe de fonctionnement

Le partenaire doit créer une référence de chargement par chèque auprès de S-money. Cette référence permet de lier le compte S-money.

Lors de la création de cette référence, le serveur S-money retourne :
- La référence à indiquer sur le chèque
- L’adresse à laquelle envoyer le chèque

Le partenaire doit donc indiquer à son client :
- De réaliser un chèque à l’ordre de S-money
- D’y ajouter la référence (au dos du chèque ou à la suite S-money dans l’ordre)
- De le transmettre à l’adresse retournée

Le partenaire sera notifié :
- lors de la réception du chèque
- lorsque le chèque sera porté au crédit du compte.

Attention : Plusieurs chèques avec la même référence peuvent créditer le compte lié à celle-ci.

1.2 Macro Process

Ressources

Pour créer ou récupérer les références de virement associées à un utilisateur :

/api/[domaine_partenaire]/users/AppUserId/chequereferences
/api/[domaine_partenaire]/users/AppUserId/payins/cheques/references

Pour récupérer une référence en particulier :

/api/[domaine_partenaire]/users/AppUserId/chequereferences/id
/api/[domaine_partenaire]/users/AppUserId/chequereferences/reference
/api/[domaine_partenaire]/users/AppUserId/payins/cheques/references/id
/api/[domaine_partenaire]/users/AppUserId/payins/cheques/references/reference

Pour récupérer la liste des chargements par virement d’un utilisateur :

/api/[domaine_partenaire]/users/AppUserId/payins/cheques

Pour récupérer la liste des chargements par virement d’un utilisateur associés à une référence :

/api/[domaine_partenaire]/users/AppUserId/payins/cheques ?reference=reference

Pour récupérer un chargement par virement d’un utilisateur :

/api/[domaine_partenaire]/users/AppUserId/payins/cheques/id

2.1 Références

Contient les informations d’une référence de chèque

Propriété Type Exemple Description
Id Long 123 Id de la référence
Beneficiary SubAccountRef Objet contenant le détail du sous compte receveur.

Si non précisé, c’est le sous compte principal de l’utilisateur connecté qui est utilisé
IsMine Bool True Vrai si le titulaire du compte est également le titulaire du compte bancaire

(il s’agit d’un chargement du compte et non pas d’un paiement)
Reference String "A1B2C3D4E5" Référence à indiquer en libellé lors du chèque
BankAccount BankAccount Informations du compte vers lequel le client doit réaliser son virement

2.2 Chèques

Contient les informations d’un chargement par chèque

Propriété Type Exemple Description
Id Long 123 Id du chargement
PaymentDate DateTime 2013-09-10T15:49:58.791121+02:00 Date du chargement
Amount Long 2350 Montant du chargement (en centimes)
Status Int 1 Statut du paiement
0 = En attente
1 = Réalisé
2 = Remboursé
3 = Echec
4 = En attente de validation
5 = Annulé
6 = En attente de remise
Beneficiary SubAccountRef Objet contenant le détail du sous compte receveur.

Si non précisé, c’est le sous compte principal de l’utilisateur connecté qui est utilisé
IsMine Bool True Vrai si le titulaire du compte est également le titulaire du compte bancaire

(il s’agit d’un chargement du compte et non pas d’un paiement)
Reference String "A1B2C3D4E5" Référence à indiquer en libellé lors du chèque
Address Address Informations du compte vers lequel le client doit réaliser son virement

2.3 SUBACCOUNTREF

Cet objet permet d’identifier les comptes entre lesquels les opérations s’effectuent.

Propriété Type Exemple Description
Id Long 98 Identifiant du compte.
AppAccountId String "123" Identifiant du compte fournit par l’appli tierce.
DisplayName String "Jean Dupont" Nom d’affichage du compte
Href Uri "/api/[domaine_partenaire]/accounts/123" Uri vers le détail du compte

2.4 ADDRESS

Propriété Type Exemple Description
Name String S-money - service encaissement des chèques de la plateforme xxx Nom + service à communiquer au client pour l’envoi du chèque
Street String 2 rue des chataîgners Numéro et rue
Zipcode String 75001 Code postal
City String Paris Ville
Country String "FR" Pays (code ISO 3166-1)

Demander une référence de chargement par chèque

3.1 Envoi des données de la requête de chargement par chèque au serveur S-money

Pour demander une référence de chargement par chèque, veuillez vous référer à l’exemple présent en marge de droite.

3.2 Envoi des données d’un chargement par chèque réalisé 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 d’un chargement.

Attention, plusieurs chargements peuvent arriver avec la même référence.

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 l’opération de chargement
reference String Référence du chèque
error Int Code d’erreur pour les chargements échoués, 0 si aucune erreur.
type Int Type de l’opération
12 = chargement par chèque
status Int Statut de l’opération
-1 = inconnu
0 = en attente
1 = complété
2 = remboursé
3 = refusé
4 = en attente de validation
5 = annulé
6 = en attente de remise
userid String Identifiant de l’utilisateur chez l’application tierce
userstatus Int Statut de l’utilisateur
0 = Non confirmé
1 = OK
2 = Gelé
3 = A la volée
4 = En cours de fermeture
5 = Fermé

Récupérer la liste des références de chargement par chèque

Pour récupérer la liste des références de chargement par chèque, veuillez vous référer à l’exemple présent en marge de droite.

Récupérer une référence de chargement par chèque

Pour récupérer une référence de chargement par chèque, veuillez vous référer à l’exemple présent en marge de droite.

Cas d’erreurs

Code HTTPCode erreurExplication
404 822 Cette référence de virement n’existe pas.

Récupérer la liste des chargements par chèques

Pour récupérer la liste des chargements par chèques, veuillez vous référer à l’exemple présent en marge de droite.

Récupérer la liste des chargements par chèques

Pour récupérer la liste des chargements par chèques, veuillez vous référer à l’exemple présent en marge de droite.

Récupérer un chargement par chèque

Pour récupérer un chargement par chèque, veuillez vous référer à l’exemple présent en marge de droite.

Cas d’erreurs :

Code HTTP Code erreur Explication
404 356 Opération introuvable

Récupérer un chargement par chèque

Pour récupérer un chargement par chèque, veuillez vous référer à l’exemple présent en marge de droite.

Cas d’erreurs :

Code HTTP Code erreur Explication
404 356 Opération introuvable