Faire respecter les limites de dépenses des agents avec x402, AP2 et le passage en caisse délégué

Objectif

État au 25 octobre 2026. Rattacher chaque paiement à une autorisation utilisateur délimitée, y compris pour les achats sans supervision et les relances. Vérifier à nouveau le périmètre de x402, les schémas de contraintes AP2 et la version datée d’ACP choisie avant de mettre en œuvre cette procédure proposée. Les champs des protocoles permettent d’exprimer des contrôles ; un composant indépendant doit réellement les appliquer.

Prérequis

Utiliser une passerelle de paiement ou un composant de signature qui applique la politique en dehors du modèle, un registre durable des autorisations, des interfaces d’approbation authentifiées et un accès aux enregistrements d’état des paiements. Désigner les responsables des transactions non résolues. Pour chaque autorisation, consigner la révision du protocole, la devise ou l’actif, la représentation du montant, les destinataires autorisés et l’échéance avant de permettre toute dépense.

Étapes

1. Fixer un plafond par transaction. Le Payment Mandate d’AP2 définit payment.amount_range. L’autorisation déléguée d’ACP fournit max_amount, la devise et l’échéance. Pour x402, comparer les exigences de paiement annoncées à la politique locale avant de signer. Appliquer le plafond au montant final autorisé, frais compris s’ils figurent dans le total du passage en caisse.

2. Comptabiliser les dépenses cumulées. Le champ payment.budget d’AP2, utilisé avec payment.agent_recurrence, impose que le montant demandé ajouté aux montants des mandats fermés précédents reste dans la limite maximale ; l’approbation ajoute le montant au total cumulé. Implémenter la vérification et la réservation de manière atomique dans un stockage partagé. La règle comptable proposée consiste à maintenir les montants des tentatives non résolues en déduction du budget disponible jusqu’au rapprochement de leur résultat. La spécification principale de x402 exclut la gestion des budgets côté client.

3. Restreindre les destinataires et les instruments de paiement. AP2 fournit checkout.allowed_merchants, ainsi que des contraintes sur le bénéficiaire et l’instrument de paiement. ACP lie son autorisation d’utilisation à un marchand et à une session de passage en caisse. Pour x402, maintenir une liste d’autorisation externe couvrant l’origine de la ressource, le destinataire du paiement, l’actif et le réseau. Ne pas considérer un texte décrivant le marchand comme une identité vérifiée.

4. Lier l’approbation humaine à des conditions concrètes. Présenter à l’acheteur le destinataire, les articles, le montant total, l’instrument de paiement et l’échéance. Pour une délégation préalable, présenter plutôt les limites autorisées. Le cadre d’autorisation d’AP2 exige l’évaluation des contraintes et traite les contraintes inconnues comme des échecs. Sa réponse unresolved_constraint peut déclencher une approbation directe. À titre de politique locale, exiger une nouvelle approbation pour les modifications hors du périmètre approuvé, même si un justificatif de paiement reste techniquement utilisable.

5. Relier les preuves sans divulguer les justificatifs. Consigner les références des approbations et des mandats, la décision de politique, le montant réservé, l’identifiant de passage en caisse ou de ressource, l’identifiant du paiement et le résultat final. Les Payment Receipts d’AP2 sont liés au mandat fermé et portent l’état du paiement. Conserver les justificatifs signés sensibles dans un stockage de preuves à accès restreint ; les journaux d’audit courants doivent contenir des références plutôt que des éléments réutilisables pour payer. Effectuer séparément le rapprochement du paiement et de la livraison.

6. Tester les cas de refus avant le lancement. Dans un environnement hors production, essayer une approbation expirée, un marchand interdit, une devise modifiée, un montant supérieur au plafond, des achats simultanés et une réponse interrompue. Vérifier que les tentatives rejetées ne créent aucune nouvelle autorisation et que les tentatives non résolues ne rétablissent pas silencieusement la capacité de dépense. Il s’agit de contrôles d’acceptation proposés, et non de résultats de tests revendiqués.

Résultat attendu

Chaque tentative autorisée dispose d’une approbation traçable, d’une réservation budgétaire et, à terme, d’un résultat rapproché. Les demandes rejetées restent explicables sans donner au modèle le pouvoir de passer outre la décision. Une personne chargée de la revue peut distinguer les dépenses demandées, autorisées et réalisées.

Limites et base de vérification

Cette procédure n’a pas été testée auprès de prestataires de paiement. Les budgets couvrant plusieurs prestataires nécessitent une comptabilisation partagée qui dépasse les objets de chaque protocole. Le tableau des plages de montants d’AP2 précise des unités monétaires mineures entières, tandis qu’un exemple utilise des décimales ; résoudre cette incohérence dans le contrat d’implémentation avant d’accepter des montants. Aucune conversion n’est déduite ici. Les reçus signés documentent les résultats du protocole ; ils ne prouvent pas la livraison physique.