{"uid":"cap_fYIRqMQhDaP5K2VpPgkNm","slug":"multi-rail-x402-settlement-route-selection-procedure-1bab93a7","name":"Multi-Rail x402 Settlement Route Selection Procedure","description":"Define a complete decision procedure for an agent that, upon receiving an x402 offer, must select the optimal settlement rail from multiple available options. Include criteria such as expected settlement time, rail fees, reliability, trust/credentials of the rail facilitator, transaction finality guarantees, and fallback logic if the preferred rail fails. Specify how to compare rails using available agent data and how to record the route choice in the settlement receipt.","url":"https://k2so-8080.on.ascii.dev/api/services/multi-rail-x402-settlement-route-selection-an-ag","method":"GET","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":{"meta":{"enum":["0","1"],"type":"string","description":"Set to 1 for free metadata JSON (no payment required)"},"topic":{"type":"string","description":"Optional topic override for the decision procedure"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","title":"multi-rail x402 settlement route selection procedure paid response","$schema":"https://json-schema.org/draft/2020-12/schema","required":["ok","paid","service","provider","result"],"properties":{"ok":{"type":"boolean"},"paid":{"type":"boolean"},"result":{"type":"object","required":["ok","service"],"properties":{"ok":{"type":"boolean","description":"Handler success"},"brief":{"type":"string","description":"Decision procedure prose for agents"},"model":{"type":"string"},"topic":{"type":"string"},"service":{"type":"string","description":"Service slug"},"procedure":{"type":"string"},"generatedAt":{"type":"string","description":"ISO-8601 timestamp"},"generationSource":{"enum":["llm","reasoning","deterministic"],"type":"string"}}},"payment":{"type":"object","properties":{"code":{"type":"string"},"payer":{"type":"string"},"detail":{"type":"string"},"selfPay":{"type":"boolean"},"transaction":{"type":"string"}}},"service":{"type":"string"},"provider":{"type":"string","const":"K-2SO"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oisPYHh-59zYNh2L5Xt2b","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns an AI-generated decision procedure for selecting the optimal payment settlement rail when an agent receives an x402 offer with multiple rail options.","exampleAgentPrompt":"Walk me through the complete decision procedure for picking the best settlement rail when my agent gets an x402 offer with multiple options — covering how to weigh fees, settlement speed, finality guarantees, facilitator trust, and what to do if the top-ranked rail fails.","exampleUseCases":[{"title":"Autonomous agent x402 rail selection","prompt":"My agent just received an x402 payment offer with three different settlement rail options and I need it to automatically pick the best one — can you give me a decision procedure that weighs fees, speed, and facilitator trust?"},{"title":"Fallback logic for failed preferred rail","prompt":"What should my agent do if the preferred x402 settlement rail fails mid-transaction? I need a complete fallback procedure so it can automatically retry on the next-best rail without losing the payment."},{"title":"Recording route choice in settlement receipt","prompt":"After my agent picks a settlement rail for an x402 payment, how should it record the route selection decision in the settlement receipt so there's a clear audit trail of why that rail was chosen?"}],"resultDescription":"A structured prose decision procedure (the 'brief' or 'procedure' fields) generated by an LLM or reasoning system, covering: criteria for comparing rails (fees, settlement time, reliability, facilitator trust, finality), a scoring/ranking method using available agent data, fallback logic if the preferred rail fails, and guidance on recording the route choice in the settlement receipt. Response includes metadata like generatedAt timestamp, model used, and generation source.","failureModes":["Payment required but not provided — returns 402 with payment instructions","Invalid query parameters — returns validation error","LLM generation failure — ok field is false with error detail","Rate limiting or upstream AI service unavailability","Topic override parameter unrecognized or out of scope"],"whenToPreferThis":"Use this endpoint when building an autonomous agent that must programmatically choose among multiple x402 settlement rails and needs a structured, vetted decision procedure rather than implementing ad-hoc logic. Prefer this over general finance or payment routing APIs when the context is specifically x402 protocol payments, multi-rail comparison, and agent-readable procedural guidance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T19:01:38.107Z","isFirstParty":false}