Bank account

Resources

Access to a bank account:

 Access to bank accounts of the connected user
/api/[domainePartenaire]/users/appuserid/bankaccounts/
Access to a bank account of the connected user
/api/[domainePartenaire]/users/appuserid/bankaccounts/id

1. Bankaccount

Property Type Example Description
Id Long 12 Bank account identifier
DisplayName String "Compte Bancaire" Bank account name
Bic String "CMCIFR2A" Bank Identifier Code (BIC)
Iban String "FRXXXXXXXXXXX XXXXXXXXXXXX" International Bank Account Number (IBAN)
IsMine Bool true Ownership of the user’s bank account
Status Int 1 Bank account status
1 : Validated
2 : Waiting validation
3 : Refused
Holder Holder Objet précisant le nom et prénom du titulaire du compte bancaire
Demands Demands Objet fournissant les détails de la demande de validation du compte bancaire (RIB)

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. Obligatoire si le compte bancaire n’appartient pas à l’utilisateur connecté

3. Demands

Propriété Type Exemple Description
Id Long 125 Identifiant de la demande de RIB
RequestDate DateTime 2018-01-09T15:55:44 Date de la demande
Status Int 0 Statut de la demande :
0 = Incomplète
1 = En cours
2 = Refusée
3 = Acceptée
Reason String Raison pour laquelle la demande a été refusée
VoucherCopies List < Attachment > Liste des pièces justificatives

Create a bank account (BIC / Iban)

To create a bank account (BIC / IBAN ), please have a look at the example in the right margin of this page.

Error cases:

HTTP Code Error code Explication
400 176 Invalid alias of the bank account
400 179 Incorrect IBAN: IBAN contains invalid characters (different from a-z, A-Z or 0-9)
400 180 Incorrect IBAN: IBAN presents an invalid structure: the first four characters must be structured as follows "letter letter number number"
400 181 Incorrect IBAN: The verification numbers of IBAN are invalid: the allowed values are 00, 01 or 99
400 182 Incorrect IBAN: unknown country code
400 183 IBAN incorrect: the number of characters for the country is incorrect
500 184 Incorrect IBAN
400 185 Incorrect IBAN
400 186 Incorrect BIC: BIC length is invalid
400 187 Incorrect BIC: Format of the BIC bank code is invalid
400 188 Incorrect BIC: Format of the BIC country code is invalid
400 189 Incorrect BIC: Format of the code of the BIC situation is invalid
400 190 Incorrect BIC: Format of the BIC branch code is invalid
400 556 Incorrect BIC
400 704 Parameter(s) of the missing request (s)
400 709 Adding a bank account is not allowed

Retrieve the list of bank accounts

To retrieve the list of bank accounts, please have a look at the example in the right margin of this page.

Retrieve a bank account

To retrieve a bank account, please have a look at the example in the right margin of this page.

Error case

HTTP case Error code Explication
404 302 Bank account cannot be found

Edit a bank account

In order to edit the bank account’s name, please have a look at the example in the right margin of this page.

Error cases::

HTTP Code Code Explication
404 302 Bank account cannot be found
400 176 Invalid alias of the bank account
400 573 BIC/IBAN update is being validated.
400 551 BIC/IBAN update is not available
400 704 Missing request(s) parameter(s)

Delete a bank account

In order to delete a bank account, please have a look at the example in the right margin of this page.

Error cases:

HTTP code Error code Explication
404 302 Bank account cannot be found

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" et lors de la validation ou le refus de la pièce.

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

Exemple de callback envoyé :

POST https://s-money.fr/callback?type=10&id=270978&status=2&userid=623b5620-dca3-5b73-6011-46a8871e94bc&userstatus=6