{"uid":"cap_ep6W0Pf4t6cFKCf8GcumU","slug":"x402-refund-amount-check-25f59228","name":"X402 Refund Amount Check","description":"X402 Refund Amount Check: X402 Refund Amount Check compares requested refund raw amount with original settled amount from bounded caller-supplied values without an external provider. Call X402 Refund Amount 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 Amount Check as versioned deter…","url":"https://api.delx.ai/api/v1/x402/x402-refund-amount-check?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"settled_raw":{"type":"string","maxLength":8192,"description":"Settled Raw supplied to X402 Refund Amount Check; used only for this bounded calculation and processed in memory without retention."},"requested_raw":{"type":"string","maxLength":8192,"description":"Requested Raw supplied to X402 Refund Amount Check; used only for this bounded calculation and processed in memory without retention."}}},"responseSchema":{"type":"json","example":{"result":{"drift_raw":"0","actual_raw":"1000","expected_raw":"1000","within_tolerance":true},"schema":"delx/util-x402-refund-amount-check/v1","status":"pass","evidence":{"retained":false,"input_sha256":"8f2b3a0b094ceb2d8c75d4ce4b7f179347769e2b9645666d7c973aae510291f0","external_calls":0},"operation":"delivery_contract:x402_refund_amount_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_SbFDVCFza1WyDg2GlsH6E","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":"Validates that a requested refund raw amount does not exceed the original settled raw amount for an x402 transaction, returning an explicit acceptance or rejection with mismatch reasons.","exampleAgentPrompt":"Before processing this refund, check if the requested raw amount of 1000000 is valid against the original settled raw amount of 1500000 for this x402 transaction.","exampleUseCases":[{"title":"Pre-refund validation for agent payment","prompt":"I need to validate a refund request before processing it — the original settled raw amount was 2000000 and the customer is requesting a refund of 1800000. Can you check if that refund amount is acceptable?"},{"title":"Mismatch detection on overfunded refund","prompt":"Someone submitted a refund request for 3000000 raw units but the original x402 settlement was only 2500000. Can you verify whether this refund is valid or flag the mismatch?"},{"title":"Pre-acceptance check for x402 agent delivery","prompt":"Before I accept this x402 agent delivery result, can you verify that the requested refund raw amount of 500000 doesn't exceed the originally settled raw amount of 500000?"}],"resultDescription":"Returns an explicit acceptance or rejection status for the refund, along with normalized evidence of the comparison, contract-specific validation checks, and detailed mismatch reasons if the requested refund amount exceeds the settled amount.","failureModes":["Missing or malformed settled_raw or requested_raw inputs returns an error","Non-numeric string values in either field may cause computation failure","Values exceeding maxLength of 8192 characters are rejected","Ambiguous or empty strings may produce indeterminate validation results"],"whenToPreferThis":"Use this endpoint when you need to validate x402 refund requests before processing or accepting them, specifically to ensure a requested refund does not exceed the original settled amount. Prefer this over manual comparisons when working within x402 or agent delivery workflows where auditability and explicit rejection reasons are required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T18:49:18.306Z","isFirstParty":false,"canonicalSlug":"x402-refund-amount-check-25f59228"}