IOSOR Guides
Réserver le prépayé avant le premier débit
Suivez le parcours vérifiable de la réservation au solde disponible puis au premier débit, avec libération et remboursement en cas d’échec ou d’expiration.
Le premier mouvement d’argent doit être compréhensible avant qu’une unité facturable ne circule.
IOSOR suit un parcours JIT en marque blanche : devis, réservation prépayée, exécution, attribution du résultat, puis règlement du montant réel.
Ce que représente une réservation prépayée
La réservation isole de l’argent pour un intent en attente sans faire croire que le service est terminé.
| Événement | Mouvement du portefeuille | Sens client |
|---|---|---|
| Hold créé | Disponible en baisse, réservé en hausse | Montant protégé pour cet intent |
| Intent terminé | Réservation transformée en débit | Résultat facturable obtenu |
| Échec ou échéance | Montant rendu au disponible | Aucun résultat incomplet facturé |
Les transitions doivent être atomiques.
Réservation et solde disponible
Un seul chiffre « solde » masque le risque de concurrence. Affichez séparément total, réservé et disponible.
Le calcul varie selon le service.
Surveillez aussi nombre, âge et échéance des réservations.
Le premier débit doit refléter le résultat
Le règlement dépend d’un fait observable, pas d’un clic ni d’une entrée en file.
La ligne du grand livre conserve l’intent ID de l’événement produit, le service, le montant, la devise, l’heure et l’état final. Ainsi, idempotence, retries et argent font partie de la conception du portefeuille.
Le rapprochement fonctionne dans les deux sens : état produit vers débit et débit vers preuve d’achèvement.
Les échecs avant le débit
Un échec avant completion se termine par une libération ou un parcours de remboursement explicite, jamais par une disparition inexpliquée. Une demande JIT expirée sans preuve peut libérer le hold. Pour les numéros, voir échec commande DID remboursement et échange.
- Validation rejetée avant travail : aucun débit
- Doublon avec la même clé : retour de l’intent existant
- Exécution échouée sous hold : libération complète
- Lot partiel : règlement des unités finies et retour du reste
- Issue inconnue : gel des retry et enquête pour éviter un second débit
Libération et remboursement diffèrent.
Liste de contrôle de l’acheteur
- Finance distingue-t-elle reserved, available et settled ?
- Chaque hold a-t-il une échéance et un seul intent ID métier ?
- La preuve de completion est-elle nommée pour chaque canal ?
- Release et refund sont-ils visibles sans dossier support ?
- Un doublon réutilise-t-il le résultat monétaire initial ?
- Le solde bas bloque-t-il le travail avant collision des réservations ? Vérifiez avec les arrêts sur solde bas.
Contrôlez également les droits : qui prolonge un hold, autorise un remboursement ou approuve une exception ?
Commencez avec IOSOR
Configurez vos limites d expiration de retenue prépayée et vos webhooks d état d autorisation dans la console IOSOR avant d émettre des requêtes facturables à grand volume. Vérifiez que votre intégration suit les soldes totaux, réservés et disponibles sous un identifiant de corrélation unifié. Exécutez une simulation d intention échouée pour confirmer que les requêtes non satisfaites déclenchent automatiquement une libération immédiate vers le pool disponible.
À retenir — IOSOR
Une retenue prépayée isole des fonds pour les intentions en attente afin d empêcher les conditions de concurrence et la double dépense sans fausser l activité non facturée en tant que revenu réalisé. Isoler les montants réservés des soldes disponibles offre à vos passerelles système et à vos équipes financières une vue précise et prête pour l audit de la solvabilité du compte en temps réel.
Ce guide vous a-t-il aidé ?
Guides associés
- Résoudre les écarts de timing entre les expirations de retenues et le règlement du grand livre
Maîtrisez la réconciliation asynchrone lorsque les webhooks des opérateurs arrivent après le TTL. Prévenez la dérive du grand livre, synchronisez les soldes JIT et protégez vos marges.
- Réconciliation des retenues prépayées bloquées après des pannes
Guide étape par étape pour auditer et libérer les retenues persistantes des systèmes prépayés suite à des incidents réseau.
- Détection des anomalies de vélocité des dépenses du portefeuille avant épuisement
Apprenez comment IOSOR détecte les dépenses anormales, stoppe le trafic sortant automatisé et protège vos fonds.