S-money API

Refunds

Hadassa — 2019-02-25T17:31:56Z

These codes inform you that the client asked for a refund. They come with a refund message. Funds will be automatically debited from your bank account on the same day as the message is received.

Proof code	Description	More details	Required action
MD06	Authorized operation contested	Your client asked for the refund of an authorized operation (Core system only). The order can be received until eight weeks after the direct debit.	Contact your client.
MD01	No valid mandate or unauthorized operation	When receiving a message of failed refund, the client asked for a funds return declaring it was an unauthorized operation. May be received until 13 months after the payment.	Contact your client for more details.

Remboursements

Hadassa — 2019-02-25T17:25:21Z

Ces codes vous informent que le client vous a demandé un remboursement. Ils sont accompagnés par un message de remboursement. Les fonds seront automatiquement débités de votre compte bancaire le même jour que la réception de ce message.

Code justificatif	Description	Plus de détails	Action requise
MD06	Opération autorisée contestée	Votre client a demandé un remboursement d'une transaction autorisée (système Core seulement). L'ordre peut être reçu jusqu'à huit semaines après le prélèvement.	Contactez votre client.
MD01	Aucun mandat valide ou opération non autorisée	Lors de la réception d'un message d'échec de remboursement, le client a demandé le retour des fonds en affirmant que c'était une opération non autorisée. Peut être reçu jusqu'à 13 mois après le règlement.	Contactez votre client pour plus de détails.

A specific payment cannot be executed

Hadassa — 2019-02-25T17:25:20Z

A payment can fail because of measures taken by the client, for example he refuses the direct debit or do not own sufficient funds to make the payment.
These failures are amongst the most common. When you receive one, you have to talk with the debtor in order to agree on when to send the payment order.

Proof code	Description	More details	Required action
AM04	Insufficient funds	The debtor's bank could not pay the direct debit because of insufficient funds.	Contact the client in order for him/her to supply his/her account, and send the payment once again.
MS02	The debtor refuses the direct debit	The debtor refuses this specific direct debit. This code can be received before or after the direct debit, depending on how fast the bank answers the refusal.	Contact your client.
MS03	Reason not specified	One of the most common error codes. Often used when banks chose not to use codes for more specific reasons, such as MD07 and AM04, under the reason of data protection.	Contact your client.

Un paiement spécifique ne peut pas être exécuté

Hadassa — 2019-02-25T17:25:18Z

Un paiement peut échouer en raison de mesures prises par le client, par exemple il refuse le prélèvement ou ne dispose pas de fonds suffisants pour effectuer le paiement.
Ces échecs sont parmi les plus courants. Lorsque vous en recevez un, vous devez en discuter avec le débiteur et vous mettre d'accord sur quand renvoyer l'ordre de paiement.

Code justificatif	Description	Plus de détails	Action requise
AM04	Fonds insuffisants	La banque du débiteur n'a pas pu payer le prélèvement en raison de fonds insuffisants.	Contactez le client pour qu'il provisionne son compte et renvoyez le paiement.
MS02	Le débiteur refuse le prélèvement	Le débiteur refuse ce prélèvement en particulier. Ce code peut être reçu avant ou après le prélèvement, en fonction de la rapidité avec laquelle la banque du débiteur répond au refus.	Contactez votre client.
MS03	Raison non précisée	L'un des codes d'erreur les plus courants. Souvent utilisé lorsque les banques choisissent de ne pas fournir des codes de raison plus spécifiques, tels que MD07 et AM04, sous motif de la protection des données.	Contactez votre client.

The account cannot accept SEPA direct debits

Hadassa — 2019-02-25T17:25:15Z

Some bank accounts cannot accept direct debits; They can be closed or blocked for legislative reasons or by the client. If you receive one of these mesages, you cannot set a direct debit mandate on the account. If so, ask the debtor to provide a new bank account details, or to lift the blockade on their account, and then submit a new request.

Proof code	Description	More details	Required action
AG01	Direct debits forbidden on this account for legislative reasons	A SEPA direct debit cannot be set on this type of account. It is probably a savings account.	Contact your client for information regarding the account to use.
AC04	Closed account	The account has been closed. The client may have used an old account number, or he has closed the account since the mandate has been set.	Contact your client to get the new account information.
MD07	Client deceased	You tried to set up a mandate on a deceased person's account. Extremely rare.	End the contract with the deceased client.
AC06	Account blocked for SEPA direct debits by the debtor	The account has been blocked for direct debits either by the bank or by your client. It can be blocked by default, in this case, the debtor can lift the blockade.	Contact your client to ask for a method/ a substitute payment account.
SL01	Specific service offered by the debtor's bank.	The request is facing specific instructions your client gave to his/her account, for example: blacklisted the creditor or did not whitelist him/her.	Contact your client.
AC13	The debtor account is a physical person's account	A SEPA B2B direct debit collection has been adressed to a private individual. It may be because the client gave the wrong payment account, the payment account deos not handle B2B direct debits or because the client did not know B2B mandates are restricted to professional accounts.	Contact your client to clarify the situation and agree on another means of payment (for example a SEPA Core direct debit).

Le compte ne peut pas accepter des prélèvements SEPA

Hadassa — 2019-02-25T17:25:13Z

Certains comptes bancaires ne peuvent pas accepter les prélèvements ; ils peuvent être fermés ou bloqués pour des raisons législatives ou par le client. Si vous recevez un de ces messages, vous ne pouvez pas mettre en place un mandat de prélèvement sur le compte. Le cas échéant, demandez au débiteur de fournir les coordonnées d'un nouveau compte bancaire, ou de lever le blocus sur leur compte, et ensuite soumettez une nouvelle demande.

Code justificatif	Description	Plus de détails	Action requise
AG01	Prélèvements interdits sur ce compte pour des raisons législatives	Un prélèvement SEPA ne peut pas être mis en place sur ce type de compte. Il s'agit probablement d'un compte d'épargne.	Contactez votre client pour des renseignements concernant le compte à utiliser.
AC04	Compte fermé	Le compte a été fermé. Le client peut avoir utilisé un ancien numéro de compte ou il a fermé le compte depuis la mise en place du mandat.	Contactez votre client pour obtenir les informations du nouveau compte.
MD07	Client décédé	Vous avez essayé de mettre en place un mandat sur le compte de quelqu'un qui est décédé. Extrêmement rare.	Mettez fin au contrat avec le client décédé.
AC06	Compte bloqué pour les prélèvements SEPA par le débiteur	Le compte a été bloqué pour les prélèvements soit par la banque soit par votre client. Il peut être bloqué par défaut, dans ce cas, le débiteur peut lever le blocus.	Contactez votre client pour demander une méthode/ un compte de paiement de remplacement.
SL01	Service spécifique offert par la banque du débiteur	La demande s'heurte à des instructions spécifiques que votre client a donné à son compte, par exemple : a mis le créancier sur liste noire ou il ne l'a pas mis sur liste blanche.	Contactez votre client.
AC13	Le compte débiteur est un compte d'une personne physique	Un encaissement de prélèvement SEPA B2B a été adressé à un compte d'un particulier. C'est peut-être parce que le client a donné le mauvais compte de paiement, le compte de paiement ne supporte pas les prélèvements B2B ou que le client ne savait pas que les mandats B2B sont limités aux comptes professionnels.	Contactez votre client pour clarifier et se mettre d'accord sur un autre moyen de paiement (par exemple prélèvement SEPA Core).

Internal data errors

Hadassa — 2019-02-25T17:25:11Z

These error codes are sent to you when you transfer incorrect data about the creditor, a file in an invalid format or transactions incorrectly sequenced. When receiving one of these error codes, you have to try and fix the data in your database or file, and then submit the request once again.

Proof code	Description	More details	Required actionAction
AM05	Duplicate direct debit	Collection has already been made. This can either be caused by a wrong transaction ID, or because two FIRST transactions have been submitted.	Verify the collection really is duplicated.
BE05	Creditor's ID incorrect	The given creditor's ID is incorrect or not valid.	Fix the creditor's ID and submit your request once again.
FF01	Transaction code incorrect or file's format invalid.	A mandatory field is missing in your order file, or one of the fields is not compliant with the interbank specifications.	Repare the XML file.
FF05	Incorrect direct debit type	The drect debit type shows a value other than COR, COR1 or B2B.	Verify the direct debit type.
MD02	Missing or inaccurate mandate data	The mandate data given by your client are incorrect or there are missing elements.	Update the missing or incorrect information.
RR03	The creditor's name or adress required by the regulation is incorrect or missing.	Your name or adress is missing. You can verify by yourself before transfering it.	If information is missing, modify the direct debit and submit the request once again. If it is a regulatory error, contact the client's bank.
AG02	Incorrect transaction code, or sequence error	The sequence type is not compatible with previous direct debits. For example, you send a RCUR payment to a client with no previous FRST payment.	Correct the wrong information and try again.
MD01	No valid mandate or operation not authorized	The mandate is not valide anymore on the client's account. When it is sent as a response to a RCUR payment, the mandate has been canceled by the client and can not be restored. If not, the mandate may have expired, if not used for 36 months. It is also used when a client asks for a refund, declaring this operation had not been authorized. This can happen until 13 months after the payment.	Verify a valid mandate is set up. In the case of a refund, contact your client for more details.

Erreurs de données internes

Hadassa — 2019-02-25T17:25:09Z

Ces codes d'erreur vous sont envoyés lorsque vous transmettez des données concernant le créancier incorrectes, un fichier sous un format invalide ou des transactions mal séquencées. A la réception de l'un de ces codes d'erreur, vous devez essayer de corriger les données dans votre base de données ou fichier, et ensuite soumettre la demande à nouveau.

Code justificatif	Description	Plus de détails	Action requise
AM05	Prélèvement en double	L'encaissement a déjà été fait. Cela peut être dû soit à un identifiant de transaction erroné, soit parce que deux transactions FIRST ont été soumises.	Vérifiez que l'encaissement est vraiment dupliqué.
BE05	Identifiant créancier incorrect	L'identifiant du créancier fourni est incorrect ou n'est pas valide.	Corrigez l'identifiant du créancier et envoyez la demande à nouveau.
FF01	Code de transaction incorrect ou format fichier invalide	Il manque un champ obligatoire à votre fichier d'ordre, ou un des champs est renseigné d'une manière qui ne répond pas au cahier des charges interbancaire.	Réparez le fichier XML.
FF05	Type de prélèvement incorrect	Le type de prélèvement indique une valeur autre que COR, COR1 ou B2B.	Vérifiez le type du prélèvement.
MD02	Données mandat manquantes ou inexactes	Les informations mandat fournies par votre client sont incorrectes ou il y a des éléments manquants.	Mettez à jour les informations manquantes ou erronées.
RR03	Le nom ou l'adresse du créancier exigée par la règlementation est incorrecte ou manquante.	Votre nom ou adresse est manquante. Vous pouvez vérifier par vous-même avant de le transmettre.	Si des informations manquent, modifiez le prélèvement et envoyez la demande à nouveau. S'il s'agit d'un manquement réglementaire, contactez la banque du client.
AG02	Code de transaction incorrect, ou erreur de séquence	Le type de séquence n'est pas compatible avec les prélèvements précédents. Par exemple, vous envoyez un paiement RCUR à un client sans un paiement FRST au préalable.	Corrigez les informations erronées et réessayez.
MD01	Aucun mandat valide ou opération non autorisée	Le mandat n'est plus valide sur le compte du client. Lorsqu'il est envoyé en réponse à un paiement RCUR, le mandat a été annulé par le client et ne peut pas être rétabli. Sinon, le mandat peut avoir expiré, si inutilisé pendant 36 mois. Il est également utilisé quand un client demande un remboursement, déclarant que c'était une opération non autorisée. Cela peut se produire jusqu'à 13 mois après le règlement.	Vérifiez si un mandat valable est en place. Dans le cas d'un remboursement, contactez votre client pour plus de détail.

Data errors that can be fixed with the debtor

Hadassa — 2019-02-25T17:25:08Z

When receiving one of these errors, you have to try and fix the data in your database with the help of the debtor and then submit the request once again. Errors caused by incorrect data in you order: These codes inform you there is a mistake in the data you transfered. Some can be solved with the debtor, when other are errors in your internal data or linked to the way you compiled the request file.

Proof code	Description	More details	Required action
AC01	Wrong account ID	The IBAN code or bank account details given by your client is not correct. You can verify them by yourself before transfering them.	Contact your client to confirm the right IBAN.
RC01	Invalid bank acccount details	The bank account details provided by you client is incorrect. You can verify them by yourself before transfering them.	Contact your client for the right bank account details.
RR01	The debtor account or ID required by the regulation is insufficient or missing.	Details of the debtor account are missing. You can verify them by yourself before transfering them.	If information is missing, modify the direct debit order and send the request once again. If it is a failure to comply with regulation, contact your client bank.
RR02	The debtor's name or adress details required by the regulation are insufficient or missing.	Details concerning the debtor's name or adress are missing. you can verify them by yourself before transfering them.	If it is caused by missing information, modify the file and submit it once again. If it is caused by regulatory reasons, contact the client's bank.
RR04	Regulatory reason	RR04 can only be used for a regulatory reason other than RR01, RR02 or RR03.	You have to contact your bank to be able to contact the debtor's bank and know the reason for the refusal.
BE01	The debtor's name does not match the account holder's name.	The client name of your order does not match the given actual account holder's name.	Contact your client to verify this information.

Les erreurs de données qui peuvent être corrigées avec le débiteur

Hadassa — 2019-02-25T17:25:05Z

À la réception d'une de ces erreurs, vous devez essayer de corriger les données dans votre base de données à l'aide du débiteur et ensuite soumettre la demande à nouveau. Les erreurs dues à des données incorrectes dans votre ordre : Ces codes vous informent qu'il y a une erreur dans les données que vous avez transmises. Certaines peuvent être résolues avec le débiteur, tandis que d'autres sont des erreurs dans vos données internes ou liées à la façon dont vous avez compilé le fichier de demande.

Code justificatif	Description	Plus de détails	Action requise
AC01	Mauvais identifiant de compte	Le code IBAN ou BIC fourni par votre client est incorrect. Vous pouvez vérifier par vous-même avant de les transmettre.	Contactez votre client pour confirmer le bon IBAN.
RC01	BIC Invalide	Le code BIC fourni par votre client est incorrect. Vous pouvez le vérifier vous-même avant de les transmettre.	Contactez votre client pour le bon BIC.
RR01	Le compte ou identifiant débiteur exigé par la règlementation est insuffisant ou manquant.	Les coordonnées du compte débiteur sont manquantes. Vous pouvez les vérifier par vous-même avant de les transmettre.	Si des informations manquent, modifiez l'ordre de prélèvement et envoyez la demande à nouveau. S'il s'agit d'un manquement réglementaire, contactez la banque du client.
RR02	Les renseignements du nom ou de l'adresse du débiteur exigés par la règlementation sont insuffisants ou manquants.	Des détails concernant le nom ou l'adresse du débiteur sont manquants. Vous pouvez les vérifier par vous-même avant de les transmettre.	Si c'est dû à des informations manquantes, modifiez le fichier et re-soumettez-le. Si c'est dû à des raisons réglementaires, contactez la banque du client.
RR04	Raison réglementaire	RR04 peut être utilisé que pour une raison réglementaire autre que les RR01, RR02 ou RR03.	Vous devez contacter votre banque pour demander à contacter la banque du débiteur afin connaître le motif du refus.
BE01	Le nom du débiteur ne correspond pas au nom du titulaire du compte	Le nom du client de votre ordre ne correspond pas au nom du titulaire réel du compte fourni.	Contactez votre client pour vérifier cette information.