{"uid":"cap_33n0y024TeAQsyhH67Lhb","slug":"privacy-rail-payment-verification-decision-procedure-30d594d3","name":"Privacy Rail Payment Verification Decision Procedure","description":"A decision procedure for an agent to accept, dispute, and audit an x402 payment when the payment rail hides sender, receiver, and amount. Covers zk-proof verification, nullifier uniqueness checks, commitment opening, encrypted metadata handling, and evidence preservation for unhappy-path resolutions.","url":"https://k2so.wrong.systems/api/services/privacy-rail-payment-verification-decision-proce","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":"Privacy rail payment verification decision 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":{"type":"json","example":{"ok":true,"paid":true,"result":{"ok":true,"brief":"plain prose decision procedure (120+ words)","model":"deepseek/deepseek-v4-flash-0731","topic":"string topic","service":"privacy-rail-payment-verification-decision-proce","procedure":"same as brief","generatedAt":"2026-01-01T00:00:00.000Z","generationSource":"deterministic"},"service":"privacy-rail-payment-verification-decision-proce","provider":"K-2SO"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9mZ4DCMWlQeYrk0uDl4ch","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a structured decision procedure for agents to verify, dispute, and audit x402 payments on privacy-preserving rails that hide sender, receiver, and amount.","exampleAgentPrompt":"Walk me through the full decision procedure for verifying a privacy-rail x402 payment — including zk-proof verification, nullifier checks, commitment opening, and what evidence to preserve if the payment needs to be disputed.","exampleUseCases":[{"title":"Verifying shielded x402 payment receipt","prompt":"My agent just received an x402 payment on a privacy rail where the sender and amount are hidden — give me the step-by-step procedure to verify the zk-proof and confirm the payment is valid before I release the service."},{"title":"Auditing disputed anonymous payment","prompt":"A payment came through on a privacy-preserving rail and the payer is disputing it — what evidence should my agent preserve and what steps should I follow to audit the commitment opening and nullifier to resolve the dispute?"},{"title":"Handling encrypted payment metadata","prompt":"My agent received an x402 payment with encrypted metadata on a shielded rail and I'm not sure how to process it — what's the correct procedure for decrypting and validating the metadata while ensuring nullifier uniqueness?"}],"resultDescription":"A plain-prose decision procedure (120+ words) tailored for AI agents, covering zk-proof verification steps, nullifier uniqueness checks, commitment opening validation, encrypted metadata handling, and evidence preservation for dispute resolution. The response includes the procedure text, generation source (llm, reasoning, or deterministic), model used, topic, service slug, and an ISO-8601 timestamp.","failureModes":["Payment required but not provided — returns 402 with payment details","Invalid query parameter values — schema validation error","Service temporarily unavailable — provider-side error","Topic override not recognized — may return generic procedure","Meta=1 returns free metadata JSON without the full decision procedure"],"whenToPreferThis":"Choose this endpoint when your agent needs structured, prose-form guidance for handling x402 payments on privacy-preserving rails that use zero-knowledge proofs to hide sender, receiver, and amount. Prefer it over generic payment verification endpoints when you specifically need nullifier checks, commitment opening steps, and unhappy-path evidence preservation guidance for shielded transactions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T15:25:48.109Z","isFirstParty":false}