Banqup met à votre disposition un environnement de validation client (CVE) : un sandbox avec ses propres données, séparées des vôtres. Utilisez-le pour développer et tester une intégration API, ou pour essayer des fonctionnalités dans l'application mobile, sans toucher aux factures, paiements et contacts de votre espace de production.
Qu'est-ce que l'environnement sandbox ?
Des données séparées. Rien de ce que vous créez dans le sandbox n'apparaît dans votre espace Banqup de production, et rien de ce que vous y faites ne modifie vos données réelles.
Les mêmes fonctionnalités. Le sandbox utilise la même plateforme Banqup et la même API que la production. Ce qui fonctionne dans le sandbox fonctionne dans votre espace de production.
Trois points d'accès.
Application web : app.cve.btx.banqup.com
Portail Développeur, où les développeurs créent leur app et leurs identifiants API : dev.cve.btx.banqup.com
Documentation développeur du sandbox : docs.cve.btx.banqup.com
Tester une intégration API dans le sandbox
Commencez par le guide de démarrage de la documentation du sandbox. Il explique quel flux d'authentification votre intégration doit utiliser.
Votre développeur crée l'app et ses identifiants client sur le Portail Développeur du sandbox. Les identifiants sont propres à un environnement : les identifiants du sandbox ne fonctionnent pas en production, et ceux de la production ne fonctionnent pas dans le sandbox.
Faites pointer l'intégration vers l'API du sandbox. Les URL de base figurent dans les guides API.
Dans l'application web du sandbox, l'administrateur de l'espace accorde à l'app l'accès à l'espace, exactement comme décrit dans Gérer les autorisations d'applications externes.
Lancez vos tests. Les factures de vente, factures d'achat et autres documents que vous créez restent dans le sandbox.
Lorsque l'intégration fonctionne comme prévu, répétez les étapes 2 et 4 en production, avec la documentation de production et le Portail Développeur de production.
Utiliser le sandbox dans l'application mobile Banqup One
Vous n'avez pas besoin d'une application distincte pour le sandbox. L'application Banqup One que vous utilisez déjà peut basculer vers le sandbox depuis ses réglages.
Ouvrez l'application Banqup One et connectez-vous comme d'habitude.
Touchez votre profil, puis Réglages.
Touchez Autres préférences.
Activez Mode sandbox.
Dans la fenêtre de confirmation, touchez Activer le mode sandbox.
L'application bascule vers le sandbox et n'affiche que les données du sandbox. Vos données réelles ne sont pas modifiées et restent disponibles lorsque vous revenez en arrière.
Pour revenir à vos données réelles, suivez le même chemin et touchez Désactiver le mode sandbox. Les données de test que vous avez créées restent dans le sandbox pour la prochaine fois.
FAQ
Ce que je fais dans le sandbox a-t-il un impact sur mon espace Banqup de production ?
Non. Le sandbox a ses propres données. Les documents, contacts et paramètres que vous y créez n'apparaissent jamais dans votre espace de production.
Puis-je utiliser mes identifiants de production dans le sandbox ?
Non. Les apps, identifiants client et autorisations d'espace sont configurés par environnement. Créez-les sur le Portail Développeur du sandbox pour vos tests, puis à nouveau sur le Portail Développeur de production lors de la mise en service.
Où trouver la documentation API du sandbox ?
Sur docs.cve.btx.banqup.com. Vous y trouvez les mêmes guides, les mêmes recettes et le même explorateur d'API que dans la documentation de production.
J'ai activé le mode sandbox dans l'application mobile et mes factures ont disparu. Que s'est-il passé ?
Rien n'est perdu. L'application affiche le sandbox, qui reste vide tant que vous n'y ajoutez pas de données de test. Désactivez Mode sandbox dans Réglages > Autres préférences pour retrouver vos données réelles.