# Documentation mbelon

*Version 2.3 · mise à jour le 22 octobre 2026*

mbelon est une plateforme de gestion d'appareils Android vendus à crédit : verrouillage à l'échéance, déverrouillage au paiement, libération à la fin du contrat. Cette documentation est publique et existe en deux formes : une page lisible et une version Markdown à la même adresse, suivie de « .md ».

## Pages disponibles

- Documentation de l'API (/documentation-api) : authentification, signature, routes, erreurs, webhooks. Version Markdown : /documentation-api.md
- Guide d'intégration pour les plateformes de vente (/documentation-integration) : le parcours complet, du compte à la fin du contrat. Version Markdown : /documentation-integration.md
- Communauté des développeurs (/community) : questions, idées et recettes. Version texte : /community.md

## Nouveautés

- 22 octobre 2026 (version 2.3) : suivi régulier de la position (POST /devices/:reference/locate avec interval_minutes de 30 à 360 et duration_hours jusqu’à 720 ; arrêt par POST /devices/:reference/locate/stop ; champ tracking), phrase de contrat par compte et par vendeur dans la notification permanente du téléphone (routes /contract-notice), notification unique sur l’application 2.9.5, localisation discrète par défaut, remise de la localisation du téléphone dans son état d’avant, trois essais au plus par demande, nouveaux codes d’erreur CONTRACT_NOTICE_INVALID et LOCATION_TRACK_INVALID.
- 17 octobre 2026 (version 2.2) : état ordonné et état réel de chaque appareil (applied_state, command.state), diagnostic « pourquoi il n’est pas verrouillé » (diagnosis, ready_to_deliver, health_report), webhooks device.silent et device.lock_unconfirmed, applications installées et applications autorisées pendant le verrouillage (GET/PUT /lock-apps), raisons d’échec de la localisation, application 2.9.3 (veille permanente, vérification automatique du paiement).
- 15 octobre 2026 (version 2.1) : fichier d'enrôlement prêt à ouvrir pour chaque téléphone (Windows, Linux, macOS) avec POST /devices/:reference/enrollment/file et dans le portail, références vendeur et client dans les webhooks d'enrôlement, toutes les adresses remises par le nom de domaine, questions fréquentes élargies.
- 15 octobre 2026 (version 2.0) : enrôlement complet par l'API (QR code, codes courts, commande, état), webhooks device.enroll_failed et device.enroll_expired, comptes Google de protection par appareil, vendeur indépendant, boutons du portail adaptés à l'état de l'appareil, bouton « Localiser » toujours disponible, communauté des développeurs.
- Windows et macOS : pas disponible pour le moment. Ils restent dans la liste des types d'appareil ; l'enregistrement répond 422 DEVICE_TYPE_NOT_AVAILABLE.
- Chaque page de documentation indique sa version et sa date de mise à jour.

## Pour commencer

- 1. Créez votre compte, puis ouvrez « Vérifier mon compte » : choisissez le type de compte (partenaire ou entreprise), renseignez votre société et déposez les six documents.
- 2. Une fois le compte vérifié, rechargez votre portefeuille (Mobile Money, carte) : chaque appareil enregistré est payé d'avance pour la durée choisie, de 1 à 6 ans.
- 3. Récupérez votre clé d'API et votre secret de signature dans le menu « Intégration ».
- 4. Appelez l'API : enregistrez vos appareils, commandez-les, suivez leur état.

## Appareils pris en charge

Téléphones, tablettes, téléviseurs et boîtiers, terminaux professionnels Android, à partir d'Android 8.0. La liste des marques est sur /supported-devices. Windows et macOS : pas disponible pour le moment (les types figurent dans la liste, mais l'enregistrement est refusé proprement). Non pris en charge : iPhone et iPad, Linux, et Huawei HarmonyOS NEXT (qui n'exécute pas les applications Android). Les appareils Android sans services Google sont pris en compte par un canal d'attente propre à mbelon. Les nouvelles fonctions sont publiées dans cette documentation : consultez-la régulièrement. Pour toute question, écrivez au support depuis votre compte ou posez-la dans la communauté des développeurs.

## Je veux… (où chercher)

| Je veux | Où |
| --- | --- |
| Comprendre le parcours complet | Guide d’intégration (/documentation-integration), étapes 1 à 7 |
| Brancher ma plateforme de vente, mon ERP ou mon prestataire de paiement | Guide d’intégration, étape 9 : recettes par type de plateforme |
| Signer mes appels et connaître chaque route | Documentation de l’API (/documentation-api) |
| Savoir si mes appareils sont bien protégés | Documentation de l’API, section Protection ; guide d’intégration, étape 8 |
| Comprendre une erreur ou un comportement inattendu | Guide d’intégration, étape 10 : problèmes fréquents |
| Connaître les appareils pris en charge | Page des appareils pris en charge (/supported-devices) |
| Poser une question à d'autres développeurs | Communauté des développeurs (/community) |
| Savoir ce qui a changé | Section « Nouveautés » de cette page |

## Questions fréquentes

| Question | Réponse |
| --- | --- |
| Un vendeur peut-il travailler sans ouvrir le portail mbelon ? | Oui. Avec une clé liée à son vendeur (ou le mode vendeur strict), il enregistre, enrôle, verrouille, déverrouille, déclare perdu, volé ou retrouvé et localise ses appareils par l'API. Voir « Vendeur indépendant ». |
| Comment obtenir le QR code et les codes d'enrôlement sans le portail ? | GET /devices/:reference/enrollment (QR en image base64, contenu et adresse), POST .../enrollment/activation-code (code court), .../activation-password (mot de passe choisi), .../command (commande pour ordinateur). |
| Comment savoir qu'un enrôlement a échoué ou expiré ? | Webhooks device.enroll_failed et device.enroll_expired, ou le champ enrollment de la fiche de l'appareil (status PENDING, ENROLLED ou FAILED). |
| Chaque vendeur a-t-il son propre portefeuille chez mbelon ? | Non. Un seul portefeuille, celui du compte. Votre plateforme peut débiter chaque vendeur de son côté ; si mbelon répond 402 INSUFFICIENT_BALANCE, rien n'est enregistré. |
| Peut-on ajouter un compte Google de protection par vendeur ou par appareil ? | Oui : frp_account_ids à l'enregistrement ou PUT /devices/:reference/frp-accounts. Les comptes de mbelon, du partenaire et de l'appareil se cumulent. Protection disponible à partir d'Android 11. |
| Que peut faire le client quand son téléphone est verrouillé ? | Par défaut : le numéroteur reste utilisable (appels, codes de forfait). Vous pouvez autoriser des applications, interdire les appels sortants ou ouvrir le magasin d'applications avec les règles de verrouillage. |
| Existe-t-il une autre façon d'enrôler qu'avec le QR code ? | Oui, quatre : le QR code, le code d'activation court (à taper dans l'application), un fichier prêt à ouvrir fait pour le téléphone (POST .../enrollment/file, Windows ou Linux/macOS), ou la commande. Le fichier et la commande demandent un ordinateur relié par câble ; le fichier télécharge adb tout seul. |
| Un appareil enrôlé peut-il être remboursé ? | Non. Aucun remboursement n'est prévu une fois un appareil enrôlé. Précisez-le à vos clients dans vos propres conditions. |
| Un vendeur voit-il les appareils d'un autre vendeur ? | Non. En mode vendeur strict, un appareil qui n'appartient pas au vendeur annoncé répond 404, jamais 403, comme s'il n'existait pas. |
| Windows et macOS sont-ils pris en charge ? | Pas disponible pour le moment. Les types existent dans la liste ; l'enregistrement répond 422 DEVICE_TYPE_NOT_AVAILABLE. |
| Peut-on localiser un appareil verrouillé ? | Oui, à tout moment, par le partenaire comme par le vendeur : POST /devices/:reference/locate puis GET /devices/:reference/locations. |
| Où poser une question à d'autres développeurs ? | Dans la communauté des développeurs (/community). Lecture libre ; seuls les comptes vérifiés et l'équipe publient. Version texte : /community.md. |
| Mon téléphone ne s’est pas verrouillé, pourquoi ? | Le statut est l’ordre donné ; l’état réel est confirmé par le téléphone (applied_state, command.state). Lisez diagnosis dans la fiche de l’appareil : chaque code dit quoi faire. Voir « Dépannage : mon téléphone ne s’est pas verrouillé » dans la documentation de l’API. |
| Dois-je informer mes clients ? | Oui. Indiquez dans votre contrat la localisation de l’appareil et la consultation de la liste des applications installées. |

## Communauté des développeurs

La communauté (/community) rassemble les questions, idées et recettes d'intégration. Tout le monde peut lire, sans compte ; seuls les comptes vérifiés et l'équipe mbelon peuvent publier. Ne publiez jamais de mot de passe, de clé ni de jeton : ils sont refusés automatiquement.

Version texte pour les outils de lecture : /community.md (liste) et /community.md?thread=<identifiant> (un sujet avec ses réponses).