Compte bancaire (BIC/IBAN)

Ressources

L’accès au compte bancaire :
- Accès aux comptes bancaires d’un utilisateur connecté
/api/[domainePartenaire]/users/appuserid/bankaccounts/
- Accès à un compte bancaire d’un utilisateur connecté
/api/[domainePartenaire]/users/appuserid/bankaccounts/id

1. Bankaccount

Propriété Type Exemple Description
Id Long 12 Identifiant du compte bancaire
DisplayName String "Compte Bancaire" Nom du compte bancaire
Bic String "CMCIFR2A" Bank Identifier Code (BIC)
Iban String "FRXXXXXXXXXXX XXXXXXXXXXXX" International Bank Account Number (IBAN)
IsMine Bool true Appartenance du compte bancaire à l’utilisateur
Status Int 1 Statut du compte bancaire
1 : Validé
2 : En attente de validation
3 : Refusé
Holder Holder Objet précisant le titulaire du compte bancaire. Obligatoire si le compte bancaire n’appartient pas à l’utilisateur connecté

2. Holder

Propriété Type Exemple Description
FirstName String "John" Prénom du titulaire du compte bancaire
LastName String "Doe" Nom du titulaire du compte bancaire

Enregistrer un compte bancaire (BIC/IBAN)

Pour enregistrer un compte bancaire (BIC/IBAN) veuillez vous référer à l’exemple présent en marge de droite de cette page.

Cas d’erreurs :

Code HTTP Code erreur Explication
400 176 Alias du compte bancaire invalide
400 179 IBAN incorrect : l’IBAN contient des caractères invalides (autre que a-z, A-Z, ou 0-9)
400 180 IBAN incorrect : l’IBAN présente une structure invalide : Les quatre premiers caractères doivent être de la forme "lettre lettre chiffre chiffre"
400 181 IBAN incorrect : Les chiffres de vérification de l’IBAN sont invalides : Seules les valeurs 00, 01 ou 99 sont valides
400 182 IBAN incorrect : Code pays inconnu
400 183 IBAN incorrect : Nombre de caractères pour le pays incorrect
500 184 IBAN incorrect
400 185 IBAN incorrect
400 186 BIC incorrect : Longueur de BIC invalide
400 187 BIC incorrect : Format du code de banque du BIC invalide
400 188 BIC incorrect : Format du code de pays du BIC invalide
400 189 BIC incorrect : Format du code de situation du BIC invalide
400 190 BIC incorrect : Format du code de branche du BIC invalide
400 556 BIC incorrect
400 704 Paramètre(s) d’appel manquant(s)
400 709 Ajout d’un compte bancaire non autorisé

Récupérer la liste des comptes bancaires

Pour récupérer la liste des comptes bancaires veuillez vous référer à l’exemple présent en marge de droite de cette page.

Récupérer un compte bancaire

Pour récupérer un compte bancaire veuillez vous référer à l’exemple présent en marge de droite de cette page.

Cas d’erreurs :

Code HTTP Code erreur Explication
404 302 Compte bancaire introuvable

Modifier l’intitulé d’un compte bancaire

Pour modifier l’intitulé d’un compte bancaire veuillez vous référer à l’exemple présent en marge de droite de cette page.

Précision :
Seul le paramètre "displayname" du compte bancaire est modifiable.
Pour modifier le BIC et l’IBAN d’un compte bancaire, il faut le supprimer puis créer un nouveau compte bancaire avec les nouvelles coordonnées.

Cas d’erreurs :

Code HTTP Code Explication
404 302 Compte bancaire introuvable
400 176 Alias du compte bancaire invalide
400 573 La mise à jour du BIC/IBAN est en cours de vérification.
400 551 La mise à jour du BIC/IBAN n’est pas disponible.
400 704 Paramètre(s) d’appel manquant(s)

Supprimer un compte bancaire

Pour supprimer un compte bancaire veuillez vous référer à l’exemple présent en marge de droite de cette page.

Cas d’erreurs :

Code HTTP Code erreur Explication
404 302 Compte bancaire introuvable

Envoi du Rib d’un compte bancaire en attente de validation

Un compte bancaire qui a le statut "En attente de validation" doit être vérifié par S-money.

Afin d’obtenir la validation du dit compte bancaire, il faut :
- Effectuer une demande de KYC
- Envoyer la copie du Rib

Pour envoyer la copie du Rib du compte bancaire en attente de validation via l’API, veuillez vous référer à l’exemple présent en marge de droite de cette page.

Pour consulter la liste des pièces de l’utilisateur, veuillez vous référer à ce paragraphe.

Envoi des données au serveur Tiers

Le serveur tiers doit mettre à disposition une url serveur permettant au serveur S-money de le notifier lorsqu’un compte bancaire est enregistré avec le statut "En attente de validation".

L’appel du serveur S-money est effectué en méthode HTTP POST avec un content-type : application/json

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

Paramètre Type Description
type Int Type de l’opération
10 = Rib
id Long ID du compte bancaire
status Int 2 = En attente de validation
userid String Appuserid de l’utilisateur
userstatus Int Statut de l’utilisateur
6 = En attente de KYC (virements bloqués)