Environnement de test (sandbox)
L’environnement de test (ou sandbox) vous permet de tester l’implémentation de notre API Premium en toute sécurité, avec des données fictives et des transactions simulées. Vous pouvez même connecter votre propre logiciel à l’API de l’environnement de test pour effectuer des tests automatisés de bout en bout.
Cet environnement de test est uniquement accessible aux clients ayant souscrit un abonnement Payments.
Accéder à l’environnement de test
L’environnement de test est accessible à cette adresse : https://client.sandbox.memo.bank
En tant que client des abonnements Payments, vous avez reçu un e-mail vous invitant à créer votre compte pour l’environnement de test.
Alimenter votre compte
Pour alimenter votre compte, simulez un virement entrant en cliquant sur le bouton Simuler (en haut à droite de votre espace de travail), puis sur Virement entrant . Vous pourrez ensuite définir le montant et le compte à alimenter.
Documentation
La documentation de l’API Memo Bank est disponible en anglais.
Paramétrer l’API
Le paramétrage de l’API sur l’environnement de test est similaire au paramétrage de l’API sur l’environnement de production.
Simuler des opérations sortantes
Pour faciliter vos tests, nous accélérons le cycle de vie des opérations. Par exemple, les prélèvements sortants sont encaissés en quelques secondes, alors qu’en production ils ne le sont qu’à J+1 voire J+2.
Pour simuler des opérations sortantes, vous pouvez utiliser de véritables IBAN. Pour simplifier vos tests, nous mettons à votre disposition des IBAN spécifiques qui vous permettront de déclencher les principaux scénarios liés aux opérations sortantes.
Transactions confirmées
| IBAN | Scénario |
| FR241234500000ACCEPT0000000 | La transaction est acceptée. Concerne tous les types de transactions :
|
| FR941234500000ACCEPT0000001 | Toutes les transactions sont acceptées sauf le virement SEPA instantané. Cela permet de tester la stratégie instant_if_available : le virement basculera automatiquement en virement SEPA standard. |
Transactions rejetées
| IBAN | Scénario |
| FR181234500000REJECT0000000 | L’IBAN est invalide :
Concerne les transactions suivantes :
|
| FR881234500000REJECT0000001 | Le compte de la contrepartie est fermé :
Concerne les transactions suivantes :
|
| FR611234500000REJECT0000002 | La banque de la contrepartie refuse la transaction :
Concerne les transactions suivantes :
|
| FR341234500000REJECT0000003 | Le réseau interbancaire retourne une erreur : Concerne les transactions suivantes:
|
| FR071234500000REJECT0000004 | La banque de la contrepartie retourne une erreur :
Concerne uniquement le virement SEPA instantané. |
| FR771234500000REJECT0000005 | La contrepartie n’a pas un solde suffisant sur son compte : Concerne les transactions suivantes :
|
| FR501234500000REJECT0000006 | La contrepartie a refusé le prélèvement : Concerne les transactions suivantes :
|
Transactions retournées
| IBAN | Scénario |
| FR131234500000RETURN0000000 | IBAN invalide : Concerne les transactions suivantes :
|
| FR831234500000RETURN0000001 | Compte de la contrepartie fermé : Concerne les transactions suivantes :
|
| FR561234500000RETURN0000002 | Compte de la contrepartie bloqué : Concerne les transactions suivantes :
|
| FR291234500000RETURN0000003 | Transaction interdite sur le compte de la contrepartie (pour un type de compte ou pour raisons réglementaires) : Concerne les transactions suivantes :
|
| FR021234500000RETURN0000004 | Titulaire du compte décédé : Concerne les transactions suivantes :
|
| FR721234500000RETURN0000005 | Retour sans motif de la contrepartie : Concerne les transactions suivantes :
|
| FR451234500000RETURN0000006 | Retour sans motif de la banque de la contrepartie : Concerne les transactions suivantes :
|
| FR181234500000RETURN0000007 | Compte débité incompatible avec les prélèvements B2B : Concerne les transactions suivantes :
|
| FR881234500000RETURN0000008 | Solde insuffisant : Concerne les transactions suivantes :
|
| FR611234500000RETURN0000009 | Transaction non autorisée pour mandat inexistant ou invalide : Concerne les transactions suivantes :
|
| FR341234500000RETURN0000010 | Contestation de la contrepartie : Concerne les transactions suivantes :
|
Simuler des opérations entrantes
Vous pouvez simuler des virements SEPA et des prélèvements SEPA entrants de deux manières :
- sur l’interface de l'environnement de test, en cliquant sur
Simuler; - via ces endpoints de l’API, uniquement disponibles sur l’environnement de test.
Pour chaque type de transaction, vous pouvez préciser le compte à alimenter ou à débiter, ainsi que le montant. Vous pouvez également préciser le nom et l’IBAN de la contrepartie, ainsi que l’identifiant créancier SEPA et la référence unique du mandat pour les prélèvements entrants. Cela vous permet d’agir programmatiquement en fonction de ces informations. Il n’y a aucune obligation de les utiliser, ces champs sont préremplis par défaut avec de la fausse donnée.
Différences entre l’environnement de test et l’environnement de production
Pour bien distinguer l’environnement de test de votre environnement de production, un bandeau bleu est affiché en haut de l’interface de l’environnement de test. Un bandeau bleu est également affiché sur les e-mails issus de cet environnement.
Par rapport à l’environnement de production, voici quelques différences notables de la sandbox :
- la sandbox n’est pas protégée par une authentification en deux étapes. La sécurité y étant moindre, nous vous préconisons de ne pas utiliser vos vraies données de production sur la sandbox, mais de préférer des données de test ;
- les limites et plafonds de paiement sur la sandbox ne correspondent pas forcément à celles et ceux que vous avez en production. Le comportement avec une transaction d’un montant élevé pourrait donc être différent entre la sandbox et la production ;
- les ressources allouées à l’environnement de test sont inférieures à celles de la production. Dit autrement, la sandbox n’est pas le bon endroit pour faire des tests de charge.