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

  1. Finance distingue-t-elle reserved, available et settled ?
  2. Chaque hold a-t-il une échéance et un seul intent ID métier ?
  3. La preuve de completion est-elle nommée pour chaque canal ?
  4. Release et refund sont-ils visibles sans dossier support ?
  5. Un doublon réutilise-t-il le résultat monétaire initial ?
  6. 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