{"uid":"cap_7QKtPifTIx5VaCeCIiK4X","slug":"blockchain-money-map-x402-agent-commerce-error-taxonomy-normalizer-0119dc42","name":"Blockchain Money Map x402 Agent Commerce Error Taxonomy Normalizer","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-agent-commerce-error-taxonomy-normalizer","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["classify"]},"facts":{"type":"object","required":["protocol","status_code","error_code","message_excerpt"],"properties":{"protocol":{"type":"string","maxLength":500},"error_code":{"type":"string","maxLength":500},"retry_after":{"type":"string","maxLength":500},"status_code":{"type":"number"},"payment_state":{"type":"string","maxLength":500},"provider_label":{"type":"string","maxLength":500},"message_excerpt":{"type":"string","maxLength":500},"authorization_state":{"type":"string","maxLength":500}},"additionalProperties":false},"policy":{"type":"object","additionalProperties":true},"reference_facts":{"type":"object","required":["protocol","status_code","error_code","message_excerpt"],"properties":{"protocol":{"type":"string","maxLength":500},"error_code":{"type":"string","maxLength":500},"retry_after":{"type":"string","maxLength":500},"status_code":{"type":"number"},"payment_state":{"type":"string","maxLength":500},"provider_label":{"type":"string","maxLength":500},"message_excerpt":{"type":"string","maxLength":500},"authorization_state":{"type":"string","maxLength":500}},"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_AcT4UptcYu5dxUIoMzXKJ","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 normalizes blockchain/x402 agent commerce errors into a standard taxonomy given protocol, status code, error code, and message facts.","exampleAgentPrompt":"I just got an error from an x402 payment attempt — the protocol was 'x402', status code was 402, error code was 'INSUFFICIENT_FUNDS', and the message said 'balance too low to cover fee' — can you classify this into the standard agent commerce error taxonomy?","exampleUseCases":[{"title":"Classifying a failed x402 payment authorization","prompt":"My agent got back a 402 status with error code 'AUTH_EXPIRED' and message 'authorization token has expired' from the x402 protocol — can you normalize this into the standard error taxonomy so I know how to handle it?"},{"title":"Normalizing cross-provider payment errors","prompt":"I'm seeing different error codes from two x402 providers for what looks like the same rejection — one says 'PAYMENT_REJECTED' with status 402 and message 'payment not accepted', the other says 'TX_DENIED' with status 400 and message 'transaction denied by provider' — classify both and tell me if they map to the same taxonomy category."},{"title":"Debugging a stuck agent commerce workflow","prompt":"My autonomous agent's payment flow is stuck — it received protocol 'x402', status code 403, error code 'RATE_LIMITED', message 'too many requests', and the payment_state is 'pending' — classify this error so I can decide whether to retry or abort."}],"resultDescription":"A JSON response containing the normalized error taxonomy classification for the provided error facts, including the canonical error category, potentially a severity or retry hint, and normalized labels that are consistent across x402 providers and protocols.","failureModes":["Missing required fields (protocol, status_code, error_code, message_excerpt) returns a validation error","Unrecognized error codes or protocols may return an unknown/unclassified taxonomy result","Malformed input schema results in a 400-class error","x402 payment failure if USDC balance is insufficient to cover the $0.01 fee","Mode must be set to 'classify' or the request will be rejected"],"whenToPreferThis":"Choose this endpoint when your AI agent needs to deterministically normalize and classify errors received from x402 blockchain payment flows, especially when working across multiple providers that return inconsistent error codes and messages. It is ideal for agent commerce orchestration layers that need to route error handling logic based on a canonical error taxonomy rather than raw, provider-specific codes.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:49:23.236Z","isFirstParty":false}