Top up by direct debit

Ressources

La récupération des chargements par prélèvements bancaires se fait via :

- /api/[domaine_partenaire]/users/AppUserId/payins/directdebits
OU
- /api/[domaine_partenaire]/users/AppUserId/mandates/mandateid/directdebits

1.DirectDebits

Contient les informations d’un chargement par prélèvement bancaire

Propriété Type Exemple Description
Id Long 123 Id du chargement
OrderId String xh02 Identifiant du paiement chez l’application tierce
CreationDate DateTime 2014-01-10T15:49:58. 791121+02:00 Date de création du chargement
PaymentDate DateTime 2014-01-13T00:00:00. 000000+02:00 Date prévue du chargement (entre 3 et 6 jours ouvrés après la date de création)
Amount Long 2350 Montant du chargement (en centimes)
Fee Long Montant de la commission (la propriété "amount" ne comprend pas le montant de la commission)
Status Int 1 Statut du chargement
0 = En attente
1 = Réalisé
2 = Remboursé
3 = Echoué
4 = En attente de validation
5 = Annulé
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)
Message String Message du paiement (limité à 140 caractères)
Mandate MandateRef Référence du mandat utilisé pour le prélèvement
Schedules PaymentSchedule Tableau des échéances (dans le cas des prélèvements avec plusieurs échéances)
Motif String echeance-avril Motif du prélèvement

2.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/[domainePartenaire] /accounts/123" Uri vers le détail du compte

3.BankAccountRef

Cet objet permet d’identifier le compte bancaire de l’utilisateur

Propriété Type Exemple Description
Id Long 98 Identifiant du compte bancaire
Href Uri "/api/[domainePartenaire]
/bankaccounts/98"
Uri vers le détail du compte bancaire

4.MandateRef

Cet objet permet d’identifier un mandat de prélèvement

Propriété Type Exemple Description
Id Long 45 Identifiant du mandat
Href Uri "/api/[domainePartenaire]
/mandates/45"
Uri vers le détail du mandat

Créer un chargement par prélèvement

Pour créer un chargement par prélèvement référez-vous à l’exemple présent dans la marge de droite.

Les paramètres obligatoires sont :
- orderid
- mandate
- amout
- ismine

Précision  : Prévoir un délai bancaire entre le débit du compte bancaire du payeur, et le crédit du compte utilisateur bénéficiaire

Envoi des données du paiement réalisé au serveur Tiers

Le serveur tiers doit mettre à disposition une url serveur permettant au serveur S-money de le notifier de la validation du chargement par prélèvement (sous 3 à 6 jours ouvrés).

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 string Référence de l’opération de virement chez l’application tierce (orderid)
error Int Code d’erreur pour les chargements échoués, 0 si aucune erreur.
type Int Type de l’opération
7 = chargement par prélèvement
status Int Statut de l’opération
-1 = inconnu
0 = en attente
1 = complété
2 = remboursé
3 = refusé
4 = en attente de validation
sequencenumber Int Numéro de séquence du prélèvement (si prélèvement en plusieurs fois)
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 chargements par prélèvement

Pour récupérer la liste des chargements par prélèvement référez-vous à l’exemple présent dans la marge de droite.

Pour récupérer la liste des chargements par prélèvement au niveau du domaine, l’URL sera : GET /api/[domaine_partenaire]/payins/directdebits

Pour récupérer la liste des chargements par prélèvement d’un utilisateur, l’URL sera : GET /api/[domaine_partenaire]/users/appuserid/payins/directdebits

Récupérer un chargement par prélèvement

Pour récupérer un chargement par prélèvement référez-vous à l’exemple présent dans la marge de droite.

Pour récupérer un chargement par prélèvement au niveau du domaine, l’URL sera : GET /api/[domaine_partenaire]/payins/directdebits

Pour récupérer le chargement par prélèvement d’un utilisateur, l’URL sera : GET /api/[domaine_partenaire]/users/appuserid/payins/directdebits

Cas d’erreurs :

Code HTTP Code erreur Explication
404 356 Opération introuvable

Annuler un prélèvement

Pour annuler un prélèvement référez-vous à l’exemple présent dans la marge de droite.

Cas d’erreur

Code HTTPCode erreurExplication
404 356 Opération introuvable

Modifier un prélèvement

Pour modifier un prélèvement référez-vous à l’exemple présent dans la marge de droite.

Cas d’erreurs

Code HTTPCode erreurExplication
404 356 Opération introuvable