{"uid":"cap_mKt-wiR2J5KhJKeBluETz","slug":"paywalled-static-file-serving-standard-x402-merchant-a66c252c","name":"Paywalled Static File Serving Standard (x402 Merchant)","description":"Merchant-side deterministic standard for serving static digital files behind HTTP 402 micropayment. Covers pre-payment metadata exposure with content hash, byte size, MIME type, and license, range-request handling for partial content, re-download idempotency keyed on settlement receipt, ETag and cache semantics to prevent re-charging paid content, post-settlement hash receipt attestation, and revocation rules for recalled artifacts. One verdict per file.","url":"https://k2so-8080.on.ascii.dev/api/services/x402-static-file-serving-standard-merchant?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":"Paywalled static file serving standard 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_qgHJHHQ_IRZqhgEUUJcWI","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 the merchant-side decision procedure and standards brief for serving static digital files behind HTTP 402 micropayments, covering metadata exposure, range requests, re-download idempotency, ETag caching, and revocation rules.","exampleAgentPrompt":"Can you pull up the x402 static file serving standard for merchants — I need to know how to handle pre-payment metadata exposure, ETag caching to avoid re-charging, and the idempotency rules for re-downloads after settlement?","exampleUseCases":[{"title":"Building a paywalled file download server","prompt":"I'm building a merchant API that sells digital files via HTTP 402 micropayments — can you get me the full standard on how to expose content hash, byte size, MIME type, and license before payment, and what to return after settlement?"},{"title":"Implementing range-request support for paid content","prompt":"I need to add range-request handling to my x402 file server so users can resume partial downloads without being re-charged — what does the merchant standard say about that?"},{"title":"Handling revocation of recalled digital artifacts","prompt":"One of the files I'm selling via x402 needs to be recalled — what are the revocation rules I should follow according to the static file serving merchant standard?"}],"resultDescription":"A structured response containing a prose decision procedure brief ('brief') explaining the merchant-side x402 static file serving standard, covering metadata exposure, range requests, re-download idempotency, ETag and cache semantics, post-settlement hash attestation, and revocation rules. Also includes service slug, generation source (llm/reasoning/deterministic), ISO-8601 timestamp, and model identifier.","failureModes":["Missing required 'type' or 'method' fields returns a validation error","Invalid method value outside GET/HEAD/DELETE enum causes rejection","Payment not included when meta=0 (default) results in HTTP 402 challenge with payment metadata","Network timeout from the ascii.dev host","Topic override not recognized may return a generic procedure rather than a specialized one"],"whenToPreferThis":"Choose this endpoint when you need the authoritative merchant-side procedural standard for implementing x402 static file serving — specifically when you need guidance on pre-payment metadata headers, range-request semantics, re-download idempotency keyed on settlement receipts, ETag caching to prevent double-charging, hash attestation, or artifact revocation. Use meta=1 to get free metadata without paying. Prefer this over generic x402 documentation when you need a structured, agent-readable decision brief you can act on directly.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T01:12:10.390Z","isFirstParty":false,"canonicalSlug":"paywalled-static-file-serving-standard-x402-merchant-a66c252c"}