Comment obtenir un jeton Monobank et le connecter à votre suivi des dépenses

À qui s’adresse ce guide

Vous êtes client de Monobank, vous voulez voir vos dépenses dans une application de suivi sans saisir chaque café à la main, et vous préférez ne pas confier vos identifiants bancaires à un service tiers. Budgie se connecte plutôt à Monobank avec un jeton personnel : vous le créez vous-même sur la page de Monobank et le collez dans l’application.

Monobank réserve cet accès aux clients de 16 ans et plus ; les données des cartes d’enfants sont accessibles via l’accès du parent.

Ce que le jeton permet, et ce qu’il ne permet pas

Le jeton personnel Monobank sert à lire vos propres données : la liste de vos cartes et cagnottes, leurs soldes et votre relevé. L’accès personnel de Monobank n’a aucune fonction de paiement : le jeton ne peut ni envoyer d’argent ni modifier quoi que ce soit dans votre compte bancaire.

Budgie s’en sert pour deux choses seulement : récupérer la liste de vos cartes et cagnottes avec leurs soldes, et récupérer les transactions des comptes que vous choisissez.

Pas à pas

1. Ouvrez la connexion Monobank dans Budgie

Ouvrez « Nouveau compte » et touchez « Monobank » sous « Synchronisation des comptes ». Si vous configurez encore l’application, l’accueil propose la même connexion Monobank. Vous arrivez sur l’écran « Connecter Monobank ».

2. Obtenez votre jeton personnel auprès de Monobank

• Touchez « Obtenir le jeton API » en haut de l’écran. La page API de Monobank, api.monobank.ua, s’ouvre directement dans Budgie. Vous pouvez aussi ouvrir cette adresse dans n’importe quel navigateur.
• Connectez-vous en scannant le QR code de cette page avec l’application Monobank. Un QR code se scanne plus facilement depuis un second écran : ouvrir la page sur un ordinateur est souvent plus rapide.
• Créez votre jeton personnel sur cette page et copiez-le.

3. Collez le jeton dans Budgie

De retour sur « Connecter Monobank », collez le jeton dans le champ du bas ; le bouton à côté le colle depuis le presse-papiers en une touche. Le champ masque le jeton pendant la saisie. Touchez ensuite « Récupérer les comptes ».

4. Choisissez vos cartes et cagnottes

Un seul jeton couvre toutes vos cartes Monobank. Budgie affiche d’abord vos cartes, puis vos cagnottes dans une section à part ; cochez celles que vous voulez ou utilisez « Tout sélectionner », puis touchez « Continuer ».

5. Choisissez la profondeur d’historique

Monobank envoie environ un mois d’historique par minute, pour chaque compte sélectionné : vous arbitrez donc entre profondeur et temps d’attente.

• « 1 dernier mois » : environ une minute.
• « 3 derniers mois » : environ 3 minutes. C’est le choix par défaut.
• « 6 derniers mois » : environ 6 minutes.
• « Les 12 derniers mois » : environ 12 minutes.
• « Toute la période » : peut prendre des heures sur un compte ancien.
• « Ne pas synchroniser l’historique » : rien du passé n’est importé, seulement les nouvelles transactions à partir de maintenant.

Les durées sont par compte : trois mois pour deux cartes, c’est environ six minutes. Une année ou toute la période continue de se charger en arrière-plan, beaucoup plus lentement quand l’application est fermée ; laisser Budgie ouvert accélère donc les choses.

6. Touchez « Démarrer la synchronisation »

C’est toute la configuration. Vos cartes et cagnottes apparaissent comme des comptes regroupés sous Monobank, chacun avec son interrupteur, et les transactions commencent à arriver.

Ce qui se passe après la connexion

• Les nouvelles transactions continuent d’arriver en arrière-plan, même quand vous n’utilisez pas l’application, mais plus lentement qu’avec Budgie ouvert.
• Les achats arrivent avec le code de catégorie de commerçant fourni par votre banque, et Budgie s’en sert pour classer d’emblée une bonne partie d’entre eux. Voir catégories automatiques par code commerçant.
• Avec vos vraies dépenses sous les yeux, un budget mensuel n’est plus une devinette. Voir planification budgétaire.
• Tout ce que fait la connexion, des cagnottes aux virements entre vos propres cartes, est décrit sur la page synchronisation Monobank.

Où votre jeton est conservé

Le jeton est enregistré dans la base de données de Budgie sur votre téléphone, et l’application ne l’envoie qu’à Monobank : votre téléphone demande vos données directement à Monobank. Budgie n’a aucun serveur qui verrait votre jeton ou vos transactions.

Considérez le jeton comme une clé de votre relevé : ne le collez pas dans des messageries et ne le partagez avec personne. Si vous pensez qu’il a fuité, créez-en un nouveau sur la page API de Monobank et mettez-le à jour dans Budgie comme indiqué ci-dessous.

Dépannage

« Échec de la synchronisation » ou jeton qui ne fonctionne plus

Si Monobank refuse le jeton à plusieurs reprises, Budgie réessaie quelques fois, puis indique « Échec de la synchronisation » sur le compte et désactive sa synchronisation. Obtenez un nouveau jeton auprès de Monobank, ouvrez les paramètres du compte, touchez « Modifier » à côté de « Jeton API », collez le nouveau et enregistrez. Réactivez ensuite « Synchronisation ».

L’historique se charge lentement

C’est une limite de Monobank, pas une panne : le relevé ne peut être demandé qu’une fois par minute au maximum et couvre jusqu’à 31 jours par demande. Budgie attend la pause et reprend de lui-même, vous n’avez rien à toucher. Garder l’application ouverte reste le moyen le plus rapide de charger un long historique.

Des transactions récentes semblent erronées ou manquent

Ouvrez les paramètres du compte et resynchronisez une période : les 7, 30 ou 90 derniers jours, ou tout l’historique. Elle démarre à la prochaine synchronisation. Voir fenêtre de resynchronisation.

Foire aux questions