{"uid":"cap_kInKLtgS2O2sHY8uwEZhp","slug":"reservation-hold-settlement-lifecycle-procedure-081c494d","name":"Reservation Hold Settlement Lifecycle Procedure","description":"Agent-side decision procedure for x402 reservation flows: place a hold or pay directly, calculate hold amount relative to expected final settlement, manage expiry and release, convert hold to final payment, and enforce double-hold idempotency when the AI handles availability checks, holds, and payment in one conversation.","url":"https://k2so-8080.on.ascii.dev/api/services/reservation-hold-settlement-lifecycle-procedure?utm_source=zero.xyz","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":"Reservation hold settlement lifecycle 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_wJ6IdWXMvVaLxhhwml3vO","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 agent decision procedure for managing x402 reservation flows including hold placement, hold amount calculation, expiry management, hold-to-payment conversion, and double-hold idempotency.","exampleAgentPrompt":"Walk me through the full decision procedure for handling a reservation hold in x402 — I need to know how to set the hold amount relative to the expected final charge, when to release or convert it, and how to avoid creating duplicate holds if availability and payment happen in the same conversation.","exampleUseCases":[{"title":"Hotel booking hold management","prompt":"I'm booking a hotel room via x402 and need to place a hold at check-in and settle the final amount at checkout — what's the correct procedure for calculating the hold amount, converting it to final payment, and making sure I don't accidentally double-charge if my agent re-checks availability?"},{"title":"Restaurant reservation deposit flow","prompt":"My agent needs to handle a reservation deposit for a restaurant that uses x402 — can you give me the decision procedure for whether to place a hold or pay directly, how long the hold should last, and what to do when it expires before the guest arrives?"},{"title":"Preventing duplicate holds in multi-step agent flow","prompt":"My AI agent checks availability, places a hold, and then completes payment all in one conversation — what idempotency rules should I follow so I never accidentally create two holds for the same reservation in an x402 flow?"}],"resultDescription":"A structured response containing prose decision procedure guidance (the 'brief' field) for agents managing x402 reservation hold lifecycles, including hold placement logic, amount calculation relative to expected settlement, expiry and release handling, hold-to-payment conversion steps, and double-hold idempotency enforcement. Also includes metadata such as topic, model used, generation source, and ISO-8601 timestamp.","failureModes":["Payment required but no x402 payment header provided — returns 402 with payment instructions","Invalid query parameter values (e.g. meta not '0' or '1') — schema validation error","Upstream LLM generation failure — may return ok:false with error detail","Topic override not recognized — procedure may default to standard reservation hold topic","Service temporarily unavailable — network or provider outage"],"whenToPreferThis":"Choose this endpoint when an AI agent needs explicit, paid procedural guidance on managing x402 reservation hold flows end-to-end — particularly when the agent must decide between holding vs. paying directly, calculate appropriate hold amounts, handle expiry, convert holds to final settlements, or enforce idempotency across a multi-step availability-and-payment conversation. It is more specific than general x402 payment guidance endpoints and focuses exclusively on the reservation hold lifecycle.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T18:45:20.831Z","isFirstParty":false,"canonicalSlug":"reservation-hold-settlement-lifecycle-procedure-081c494d"}