{"uid":"cap_zbFn4woDV47RWgkRy7LPD","slug":"blockchain-money-map-x402-failure-fact-classifier-5d4e4cea","name":"Blockchain Money Map x402 Failure Fact Classifier","description":"Choose Blockchain Money Map for human-readable public blockchain reports or x402-paid agent API services.","url":"https://api.blockchainmoneymap.com/api/x402/x402-failure-fact-classifier","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"failure_facts":{"type":"object","properties":{"amount":{"type":"string","maxLength":32},"scheme":{"type":"string","maxLength":64},"network":{"type":"string","maxLength":64},"currency":{"enum":["USDC"],"type":"string"},"receiver":{"type":"string","maxLength":80},"http_status":{"type":"integer","maximum":599,"minimum":100},"retry_status":{"type":"string","maxLength":64},"x402_version":{"type":"integer","maximum":2,"minimum":1},"resource_path":{"type":"string","maxLength":160},"target_error_code":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,120}$"},"present_header_names":{"type":"array","items":{"type":"string","maxLength":80},"maxItems":40},"facilitator_error_code":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,120}$"}},"additionalProperties":false},"caller_context":{"type":"object","properties":{"client_name":{"type":"string","pattern":"^[A-Za-z0-9_. -]{1,80}$"},"environment":{"enum":["local","preview","production","test","unknown"],"type":"string"},"client_version":{"type":"string","pattern":"^[A-Za-z0-9_.:-]{1,40}$"},"integration_step":{"enum":["challenge","sign","retry","verify","settle","target_response","unknown"],"type":"string"}},"additionalProperties":false},"expected_facts":{"type":"object","properties":{"amount":{"type":"string","maxLength":32},"scheme":{"type":"string","maxLength":64},"network":{"type":"string","maxLength":64},"tool_id":{"type":"string","maxLength":120},"currency":{"enum":["USDC"],"type":"string"},"receiver":{"type":"string","maxLength":80},"resource_path":{"type":"string","maxLength":160}},"additionalProperties":false}}},"responseSchema":{"type":"json"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ORsg2yBzo18yf7A5bV_v9","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Classifies and diagnoses x402 payment protocol failure facts by comparing actual vs expected payment parameters to identify the root cause of a failed x402 transaction.","exampleAgentPrompt":"My x402 payment to resource /api/data on Base network failed at the verify step with facilitator error code 'payment.amount_mismatch' — the agent sent 0.01 USDC but the receiver expected 0.02 USDC. Can you classify this failure fact using Blockchain Money Map's x402 failure classifier?","exampleUseCases":[{"title":"Debug x402 challenge step failure","prompt":"My x402 agent hit an HTTP 402 on /api/reports and failed during the challenge step — the facilitator returned error code 'scheme.unsupported' on Base network for a 0.01 USDC payment to receiver 0xABC123. Can you classify what went wrong?"},{"title":"Diagnose x402 amount mismatch in production","prompt":"In production, my client 'MyAgent v1.2' failed to settle an x402 payment at the retry step — the expected amount was 0.05 USDC but the actual was 0.01 USDC on Ethereum, and the target returned error 'amount.insufficient'. Classify this x402 failure for me."},{"title":"Identify x402 receiver mismatch error","prompt":"During integration testing, my x402 payment to resource /api/v1/data on Base failed at the sign step with target error code 'receiver.mismatch' — expected receiver was 0xDEF456 but actual receiver was 0xXYZ789. What category of x402 failure is this?"}],"resultDescription":"A JSON response containing the classification of the x402 payment failure, identifying the failure category, likely root cause, and potentially actionable diagnostics based on the comparison between the provided failure facts and expected payment parameters.","failureModes":["Invalid input schema — missing required failure_facts fields returns a 400 error","Payment required (402) if x402 micropayment of 0.01 USDC not provided","Unknown or unrecognized error codes may result in low-confidence or unclassified output","Mismatched schema version (x402_version out of range 1-2) returns validation error","Empty or null failure_facts object yields no meaningful classification"],"whenToPreferThis":"Choose this endpoint when an AI agent or integration needs to programmatically diagnose why a specific x402 payment transaction failed — particularly when you have structured failure facts such as error codes, network, amount, and integration step available. It is purpose-built for x402 protocol debugging, unlike generic blockchain transaction status lookups or human-readable reports.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:44:58.207Z","isFirstParty":false}