Intramedial befindet sich in der eingeschränkten Beta. Bei der Registrierung oder Anmeldung müssen Sie das erhaltene Beta-Tester-Passwort angeben oder unter preview@intramedial.com eines anfordern. Vielen Dank.
Wird geladen…
settlement.listModul 47
Plane-Modul
Settlement and escrow
Halten Sie Geld gegen ein Agent-Zahlungsmandat, bis die Lieferung bestätigt ist, mit einem Protokoll, das klar sagt, wann Mittel tatsächlich flossen und wann nicht.
settlement.list liest Settlements durch ihre ganze Zustandsmaschine: Entwurf, Mandats- und Finanzierungsprüfung, gehalten, Freigabe oder Erstattung, Streit, Ablauf. Jede Mutation hängt ein Transkript-Ereignis an, und die Antwort trägt fundsMoved immer als streng validierten Fakt, nie als Annahme.
Agenten handeln, wenn die Ebene Ja sagt – und das Protokoll sagt, warum.
Leiten Sie Agent-Aktionen, Inhalts-Hashes, API-Checks, DNS-Abfragen, Webhooks, LLM-Aufrufe und Git-Commits über Intramedial – für einen signierten Beleg, den jeder prüft, ohne uns zu vertrauen.
StatusEchtes Geld braucht zwei gebundene Abhängigkeiten
Das Finanzieren und Freigeben eines positiven Betrags verlangt einen injizierten Ap2MandateVerifier und einen SettlementProvider, der nicht die eingebaute Nur-Eintrags-Art ist; sind nicht beide gebunden, antwortet fund 503, und kein Geld kann fließen. Der mitgelieferte Standard-Provider kann nur Einträge ohne Wert, nur zum Erfassen, erzeugen.
Protokoll
Das Protokoll
Was erfasst wird
state
draft, pending_mandate, pending_funding, held, releasing, refunded, closed, declined, oder .
Ein streng validiertes Boolean in jeder Antwort, auch bei Lesezugriffen; nie behauptet, ohne dass der eigene Status des Providers es stützt.
mandateId
Die AP2-Mandats-ID, erfasst, sobald fund sie verifiziert.
receipt
Ein Merkle-Beleg, über das Transkript-Ereignis des Settlements zusammengestellt, wo die Aktion einen erzeugt.
idempotencyKey
Bei jedem mutierenden Aufruf Pflicht; eine Wiederholung mit demselben Schlüssel und Body liefert die zwischengespeicherte Antwort, ein anderer Body führt zum Konflikt.
evidence
Am Settlement angehängtes Material, einschließlich seiner eigenen Belege, auf 16.384 Zeichen Inhalt begrenzt.
Mechanismus
Schritt für Schritt
So funktioniert es
Ein Settlement wird angelegt
create eröffnet ein Settlement in draft mit amountCents, currency und mindestens einer Verknüpfung zu einem Fall, Commitment oder Matter.
Die Finanzierung prüft zuerst das Mandat
fund verifiziert das AP2-Mandat über den gebundenen Verifier, bevor es den Geld-Provider überhaupt bittet, etwas zu halten; ein abgelehntes Mandat hält das Settlement in pending_mandate, unfinanziert.
Freigabe oder Erstattung führt es weiter
release und refund rufen den gebundenen Provider auf und erfassen sein gemeldetes fundsMoved erst nach Validierung gegen den vom Provider selbst behaupteten Status.
Ein Streit pausiert das Ergebnis
dispute verlangt eine angegebene reason und überführt ein gehaltenes oder in Freigabe befindliches Settlement nach disputed; es gegen ein Urteil aufzulösen braucht einen Fall, den dieser Workspace tatsächlich entschieden hat.
Ausprobieren
Live-Demo
Direkt auf dieser Seite ausführen
GET/api/v1/acp/settlement/list
// Kein Body: Das ist ein GET. Klicken Sie auf Ausführen.
Die Aufrufe dieses Moduls verändern echten Zustand oder erreichen externe Dienste, daher führt die gemeinsame Demo sie nicht aus. Melden Sie sich an, um es in Ihrem eigenen Workspace auszuführen. Doku zu settlement.list
Antworten
Die Aufrufe dieses Moduls verändern echten Zustand oder erreichen externe Dienste, daher führt die gemeinsame Demo sie nicht aus. Melden Sie sich an, um es in Ihrem eigenen Workspace auszuführen.
Code
Live-Beispiel
Eine echte Anfrage
Eine Anfrage in der Form, die die API akzeptiert, und eine Beispielantwort in der Form, die das Modul liefert.
api.intramedial.com/api/v1/acp/settlement/listGET
GET/api/v1/acp/settlement/listAuthorization: Bearer av_workspace_••••→ 200 { settlements, fundsMoved: false } (list and get always carry the fundsMoved sentinel alongside settlements)
directory.lookup öffnet ein Deposit-gestütztes Matter erst, wenn sein Settlement tatsächlich gehalten ist, nicht bloß angelegt, sodass ein Anklopfen sich nicht mit einem unfinanzierten Versprechen Einlass erkaufen kann.
Einen Streit per Urteil auflösen
Ein strittiges Settlement wird nur gegen ein Urteil zugunsten des Zahlers freigegeben, das dieser Workspace selbst entschieden hat, abgebildet auf eine Abhilfe, die dem Zahler tatsächlich etwas nimmt.
Belegen, dass Geld floss oder nicht
Ein Prüfer liest das Transkript eines Settlements und sieht fundsMoved bei jedem Schritt ehrlich erfasst, einschließlich der Zurückweisung der Behauptung eines Providers, wenn sie nicht zu seinem eigenen Status passte.
Eine Anfrage sicher wiederholen
Ein Client wiederholt nach einem Timeout einen release-Aufruf mit demselben idempotencyKey; das Settlement wird nicht zweimal freigegeben, und die ursprüngliche Antwort kommt unverändert zurück.
Wann etwas anderes passt
Geld ohne gebundenen Provider bewegen. Der mitgelieferte Standard-Provider erzeugt nur Einträge ohne Wert, nur zum Erfassen.
Ohne erfasste Verknüpfung abwickeln. create verlangt mindestens eines von caseId, commitmentId oder matterId.
Einen Streit durch Behauptung auflösen. Die Freigabe gegen einen Streit braucht ein Urteil, das dieser Workspace tatsächlich entschieden hat, nicht eine Missbrauchsbehauptung.
Nachweis
Garantien
Was es leistet und was nicht
Ein Modul ist eine starke Aussage über etwas Enges. Verlassen Sie sich genau darauf.
Es leistet
fundsMoved wird nie allein auf Zuruf eines Providers auf true gesetzt; der behauptete Status des Providers wird validiert, bevor dem Feld getraut wird.
Das Finanzieren eines Settlements prüft immer das Mandat, bevor der Geld-Provider überhaupt gebeten wird, etwas zu halten.
Ein wiederholter Idempotenzschlüssel mit anderem Request-Body wird als Konflikt abgelehnt, nie stillschweigend zweimal angewendet.
Es leistet nicht
Dass ohne gebundenen Provider, der nicht nur erfasst, Mittel in der echten Welt flossen. Das Modul setzt die Zustandsmaschine durch; es bewegt selbst kein Geld.
Dass ein Streit fair gelöst wird. Das Modul verlangt ein Urteil aus den eigenen entschiedenen Fällen dieses Workspace; es beurteilt den Streit nicht selbst.
Dass jede Lebenszyklus-Aktion für einen Agenten erreichbar ist. fund, release, refund und expire haben keine MCP-Aktions-ID; nur create, get, list, evidence und dispute haben eine.
Details
Bauhinweise
Bevor Sie bauen
Ein geschlossener Streit löst sich nach closed auf
Wurde ein Streit erhoben, nachdem ein Settlement bereits freigegeben war, geht seine Auflösung zurück auf closed mit fundsMoved: false, da das Geld bereits floss, bevor der Streit existierte.
Kein README für dieses Modul
Settlement hat kein README; alles hier Beschriebene stammt aus dem direkten Lesen seines Service-Codes und seiner Tests, nicht aus einem verfassten Scope-Dokument.
escrow ist ein Alias
Der REST-Pfad /api/v1/acp/escrow/* erreicht denselben Handler wie /api/v1/acp/settlement/*; er ist keine separate Implementierung.
Limits und Bemessung
amountCents muss eine positive sichere Ganzzahl sein; die Währung muss ein dreibuchstabiger ISO-4217-Code sein.
Der Beleg-content ist auf 16.384 Zeichen begrenzt und die description auf 2.000.
fund, release, refund und expire haben keine MCP- oder Vertrags-Aktions-ID und sind nur über REST erreichbar.
Zugriff
API & MCP
REST und MCP
Authentifizieren Sie sich mit einem Workspace-API-Schlüssel als Bearer-Token. Die Basis-URL ist https://api.intramedial.com.
REST-Endpunkte
GET/api/v1/acp/settlement/listDie Settlements dieses Workspace auflisten.
GET/api/v1/acp/settlement/getEin Settlement per ID lesen.
POST/api/v1/acp/settlement/createEin neues Settlement mit seinen Verknüpfungen eröffnen.
MCP-Aktionen
MCPcoordination.settlement.listSettlements als MCP-Aktion auflisten.
MCPcoordination.settlement.getEin Settlement als MCP-Aktion lesen.
MCPcoordination.settlement.createEin Settlement als MCP-Aktion anlegen.
Erhalten Sie je Pull Request eine Wegwerf-Arena, mit versteckten Teilnehmern und einer Datenstichprobe geforkt, von selbst entfernt, auch wenn es ihr niemand sagt.
Plane-Modul
