{"uid":"cap_LHQyTh0dguTwrEEuql2Bs","slug":"x402-refund-eligibility-check-2e18cccf","name":"X402 Refund Eligibility Check","description":"X402 Refund Eligibility Check: X402 Refund Eligibility Check evaluates caller-supplied delivery outcome against explicit refund reasons from bounded caller-supplied values without an external provider. Call X402 Refund Eligibility Check before paying for or accepting an x402 or agent delivery assembled from caller-supplied challenge and result metadata. Returns contract-specific checks, normalized evidence, mismatch reasons, and an explicit acceptance or rejection status for X402 Refund Eligibi…","url":"https://api.delx.ai/api/v1/x402/x402-refund-eligibility-check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"settled":{"type":"boolean","description":"Settled supplied to X402 Refund Eligibility Check; used only for this bounded calculation and processed in memory without retention."},"delivered":{"type":"boolean","description":"Delivered supplied to X402 Refund Eligibility Check; used only for this bounded calculation and processed in memory without retention."},"failure_code":{"type":"string","maxLength":8192,"description":"Failure Code supplied to X402 Refund Eligibility Check; used only for this bounded calculation and processed in memory without retention."},"eligible_codes":{"type":"array","items":{"type":"string","maxLength":8192},"maxItems":256,"description":"Eligible Codes supplied to X402 Refund Eligibility Check; used only for this bounded calculation and processed in memory without retention."}}},"responseSchema":{"type":"json","example":{"result":{"eligible":true,"failure_code":"post_settlement_delivery_failed"},"schema":"delx/util-x402-refund-eligibility-check/v1","status":"pass","evidence":{"retained":false,"input_sha256":"c7ff113147f00d1cbabc89249c1c35e396554cac50edbc709fcefae782738ef1","external_calls":0},"operation":"delivery_contract:x402_refund_eligibility_check"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9V54d6M0mx8-CvCWPHgLR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Evaluates caller-supplied delivery outcome metadata against explicit refund reason codes to determine whether a refund is warranted for an x402 or agent delivery payment.","exampleAgentPrompt":"Check if this x402 delivery qualifies for a refund: the payment was settled (settled=true), the item was not delivered (delivered=false), the failure code is 'TIMEOUT_408', and the eligible refund codes are ['TIMEOUT_408', 'NOT_DELIVERED_503'].","exampleUseCases":[{"title":"Agent delivery timeout refund check","prompt":"The agent task was paid for via x402 and settled, but it timed out and was never delivered. The failure code is 'TIMEOUT_408' and the eligible refund codes are ['TIMEOUT_408', 'NETWORK_ERR']. Is this eligible for a refund?"},{"title":"Verifying refund before rejecting a result","prompt":"Before I reject this x402 result, can you check refund eligibility? The payment settled, delivery did happen, the failure code is 'PARTIAL_502', and the eligible codes list is ['TIMEOUT_408', 'NOT_DELIVERED_503'] — I want to know if I have grounds for a refund."},{"title":"Validating outcome for no-fault delivery failure","prompt":"We got a failed delivery with failure code 'NOT_DELIVERED_503', the payment was settled but nothing was delivered. Check if this matches our eligible refund codes ['NOT_DELIVERED_503', 'CANCEL_410'] and whether we should issue a refund."}],"resultDescription":"Returns a structured response containing an explicit acceptance or rejection status for the refund claim, contract-specific eligibility checks, normalized evidence derived from the supplied metadata, and a list of mismatch reasons explaining why the failure code does or does not align with the eligible refund codes.","failureModes":["Missing required fields (settled, delivered) may cause validation errors","Overly long failure_code or eligible_codes strings may be truncated or rejected","An empty eligible_codes array will likely result in automatic rejection status","Ambiguous or unrecognized failure codes may yield an indeterminate or rejection result"],"whenToPreferThis":"Use this endpoint when you need a deterministic, in-memory, stateless check of whether a specific x402 payment or agent delivery outcome meets predefined refund criteria — particularly when you want normalized evidence and explicit accept/reject decisions without retaining data or calling an external oracle. Prefer this over manual logic when dealing with multiple eligible refund codes that must be matched against a single failure code in an x402 payment flow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T06:44:23.495Z","isFirstParty":false,"canonicalSlug":"x402-refund-eligibility-check-2e18cccf"}