{"uid":"cap_AipBxCBoI5K_w4miLncA_","slug":"x402-trust-layer-mpp-session-manager-b0d85c75","name":"x402 Trust Layer MPP Session Manager","description":"68 paid x402 trust infrastructure APIs: guard, semantic escrow, mandate diff, certified seller network, KYM, mandates, compliance, disputes, and orchestration.","url":"https://x402trustlayer.xyz/api/mpp/session?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["ok","status","success","action","session","settlement","recommendation","facilitator","nextSteps","savingsNote","confidence","checks_passed"],"properties":{"ok":{"type":"boolean"},"action":{"type":"string"},"status":{"type":"string"},"session":{"type":"object","required":["sessionId","status","chain","agentId","expectedCalls","callsUsed","avgPricePerCallUsdc"],"properties":{"chain":{"type":"string"},"status":{"type":"string"},"agentId":{"type":"string"},"callsUsed":{"type":"number"},"sessionId":{"type":"string"},"expectedCalls":{"type":"number"},"avgPricePerCallUsdc":{"type":"number"}}},"success":{"type":"boolean"},"nextSteps":{"type":"array","items":{"type":"string"}},"confidence":{"type":"number"},"settlement":{"type":"object","required":["status","sessionId","network","chain","agentId","callsSettled","plannedCalls","estimatedTotalUsdc","facilitatorUrl"],"properties":{"chain":{"type":"string"},"status":{"type":"string"},"agentId":{"type":"string"},"network":{"type":"string"},"sessionId":{"type":"string"},"callsSettled":{"type":"number"},"plannedCalls":{"type":"number"},"facilitatorUrl":{"type":"string"},"estimatedTotalUsdc":{"type":"number"}}},"facilitator":{"type":"object","required":["url","mppDocs"],"properties":{"url":{"type":"string"},"mppDocs":{"type":"string"}}},"savingsNote":{"type":"string"},"checks_passed":{"type":"array","items":{"type":"string"}},"recommendation":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"action":"close","status":"ok","session":{"chain":"polygon","status":"closed","agentId":"agent-mpp-usdc-test-042","callsUsed":0,"sessionId":"mpp_example","expectedCalls":9,"avgPricePerCallUsdc":0.03},"success":true,"nextSteps":["Facilitator settles session total to payTo wallet"],"confidence":0.9,"settlement":{"chain":"polygon","status":"closed","agentId":"agent-mpp-usdc-test-042","network":"eip155:137","sessionId":"mpp_example","callsSettled":0,"plannedCalls":9,"facilitatorUrl":"https://x402.dexter.cash","estimatedTotalUsdc":0},"facilitator":{"url":"https://x402.dexter.cash","mppDocs":"https://docs.dexter.cash/docs/mpp/"},"savingsNote":"Session closed with settlement metadata","checks_passed":["mpp_session","action_close","settlement_metadata"],"recommendation":"Settle aggregate USDC once on-chain via facilitator"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SLVTuqlX3CnTrrVkZG0Az","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Closes and settles a multi-payment protocol (MPP) session, returning settlement metadata and facilitator instructions for aggregate USDC on-chain settlement.","exampleAgentPrompt":"Close my x402 MPP session 'mpp_example' for agent 'agent-mpp-usdc-test-042' using an HTTP GET action and give me the settlement details so the facilitator can settle the total USDC on Polygon.","exampleUseCases":null,"resultDescription":"Returns a JSON object with session close confirmation including: session ID, agent ID, chain (e.g. Polygon), calls used vs planned, estimated total USDC owed, facilitator URL and docs link, confidence score (0–1), a list of checks passed, a savings note, next steps for on-chain settlement, and a human-readable recommendation to settle via the facilitator.","failureModes":["Invalid or expired session ID returns error with no settlement data","Missing required 'type' or 'method' fields returns schema validation error","Unsupported HTTP method (e.g. POST instead of GET/HEAD/DELETE) returns 422","Session already closed may return idempotent close or conflict error","Payment not authorized (x402 payment header missing or invalid) returns 402","Network or facilitator unreachable results in timeout or 503"],"whenToPreferThis":"Use this endpoint when you need to formally close an x402 MPP (multi-payment protocol) session and retrieve structured settlement metadata so a facilitator can execute the aggregate USDC payment on-chain. Prefer this over individual per-call payment endpoints when your agent has completed a batch of API calls and wants to settle once, reducing gas costs. Ideal when working within the x402 trust infrastructure ecosystem using the Dexter Cash facilitator on Polygon.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T18:40:57.131Z","isFirstParty":false,"canonicalSlug":"x402-trust-layer-mpp-session-manager-b0d85c75"}