{"uid":"cap_DJIgObwZaeCOhT6dzOrUm","slug":"blockchain-money-map-x402-agent-payment-recovery-playbook-bd6069cb","name":"Blockchain Money Map – x402 Agent Payment Recovery Playbook","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-payment-recovery-playbook","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"mode":{"enum":["classify"]},"facts":{"type":"object","required":["failure_phase","status_code","error_code","payment_identifier_present","receipt_present","retry_cache_policy"],"properties":{"network":{"type":"string","maxLength":500},"error_code":{"type":"string","maxLength":500},"status_code":{"type":"number"},"failure_phase":{"type":"string","maxLength":500},"provider_label":{"type":"string","maxLength":500},"receipt_present":{"type":"boolean"},"settlement_status":{"type":"string","maxLength":500},"retry_cache_policy":{"type":"string","maxLength":500},"payment_identifier_present":{"type":"boolean"}},"additionalProperties":false},"policy":{"type":"object","additionalProperties":true},"reference_facts":{"type":"object","required":["failure_phase","status_code","error_code","payment_identifier_present","receipt_present","retry_cache_policy"],"properties":{"network":{"type":"string","maxLength":500},"error_code":{"type":"string","maxLength":500},"status_code":{"type":"number"},"failure_phase":{"type":"string","maxLength":500},"provider_label":{"type":"string","maxLength":500},"receipt_present":{"type":"boolean"},"settlement_status":{"type":"string","maxLength":500},"retry_cache_policy":{"type":"string","maxLength":500},"payment_identifier_present":{"type":"boolean"}},"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_Nz9pbDCg_Lunnj4po_dTQ","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 x402 blockchain payment failures and returns a structured recovery playbook for agents to follow based on failure phase, status code, and error context.","exampleAgentPrompt":"My x402 payment failed during the settlement phase with a 402 status code, error code PAYMENT_FAILED, no receipt was issued, a payment identifier is present, and my retry cache policy is no-store — can you classify this failure and give me a recovery playbook?","exampleUseCases":[{"title":"Diagnose pre-settlement payment failure","prompt":"My agent's x402 payment failed before settlement on Base network — status code 402, error code INSUFFICIENT_FUNDS, no payment identifier or receipt present, and retry cache policy is no-cache. Classify this failure and tell me the recovery steps."},{"title":"Recover from receipt-issued payment failure","prompt":"An x402 payment on Ethereum went through and issued a receipt but settlement_status shows failed. The error code is SETTLEMENT_TIMEOUT, status 500, payment identifier is present. What's the recovery playbook for this situation?"},{"title":"Handle ambiguous agent payment error","prompt":"My AI agent got an unknown error during the authorization phase of an x402 payment — status 400, error code INVALID_PAYLOAD, no receipt, no payment identifier, retry cache policy is must-revalidate. Classify what went wrong and tell me how to recover."}],"resultDescription":"A JSON object containing a classification of the payment failure (e.g. category, severity, phase) along with a structured recovery playbook — recommended next actions, retry guidance, and contextual advice based on the provided failure facts and optional policy configuration.","failureModes":["Missing required facts fields (failure_phase, status_code, error_code, payment_identifier_present, receipt_present, retry_cache_policy) returns validation error","Unknown or unsupported error_code may yield a generic or fallback classification","Mode must be 'classify' — other values will likely be rejected","Incorrect data types for boolean fields (receipt_present, payment_identifier_present) may cause schema rejection","x402 payment for the API call itself fails if agent wallet has insufficient USDC"],"whenToPreferThis":"Use this endpoint when an AI agent is operating in an x402 payment pipeline and encounters a payment failure that requires structured triage and recovery guidance. It is especially useful when automating retry logic or routing decisions after failed blockchain micropayments, and when you need a deterministic classification rather than ad-hoc heuristics. Prefer this over general blockchain explorers or generic error handlers when the failure is specifically within the x402 payment protocol flow.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:44:54.542Z","isFirstParty":false}