{"uid":"cap_E9H82fg5TYG5En8mHT855","slug":"agent-paid-resource-control-pre-payment-review-fd5fa73b","name":"Agent Paid Resource Control – Pre-Payment Review","description":"Payment is required to receive a pre-action decision for this external resource: allow, review_required, or deny. Pay to receive an External Resource Review with decision, risk_level, payment_allowed, required_checks, and reason before the agent acts.","url":"https://agent-paid-resource-control.onrender.com/api/paid-resource/review","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"metadata":{"type":"string"}}},"responseSchema":{"type":"json","example":{"amount":"0.03","status":"created","agent_id":"agent_demo_001","currency":"USDC","decision":"review_required","review_id":"paid_resource_review_abc123","created_at":"2026-06-18T00:00:00Z","review_type":"agent_paid_resource_review","experimental":true,"resource_url":"https://example.com/premium/report","resource_type":"web_content","agent_guidance":{"after_payment":["Record payment_tx or settlement reference.","Verify that the expected_result was fulfilled.","Create a paid access evidence receipt."],"before_payment":["Confirm that the payment is bound to the intended resource_url.","Check whether this resource was already paid for in the current task window.","Confirm that the expected_result is specific enough to verify after payment."]},"evidence_fields":["agent_id","resource_url","resource_type","amount","currency","payment_protocol","payment_intent_id","expected_result","actual_result","payment_tx","memo_id","evidence_id"],"required_checks":["reputation_signal_audit","budget_policy_check","memory_use_permission_check","payment_evidence_required"],"payment_protocol":"x402","resource_control":{"budget_status":"not_checked","metadata_privacy":"passed","resource_binding":"check_required","fulfillment_check":"required","duplicate_payment_risk":"unknown","reconciliation_required":true,"evidence_receipt_required":true},"recommended_next_step":"proceed_only_after_budget_and_resource_binding_check"},"examples":{"example_d_deny":{"expected_output":{"reason":"The resource requires external tool installation and may affect customer data without sufficient provenance.","decision":"deny","risk_level":"high","payment_allowed":false,"required_checks":["tool_install_approval_gate","reputation_signal_audit","customer_data_boundary_check"]}},"example_a_allow":{"expected_output":{"reason":"The resource is low-risk, within budget, and no sensitive memory or customer data is involved.","decision":"allow","risk_level":"low","payment_allowed":true,"required_checks":["payment_evidence_required"]}},"example_b_mcp_tool":{"input":{"purpose":"Use an external MCP tool before processing customer data","agent_id":"agent_001","resource_url":"https://github.com/example/tool-server","risk_context":{"uses_memory":false,"requires_payment":false,"affects_customer_record":true,"requires_tool_installation":true},"resource_type":"mcp_tool"},"expected_output":{"decision":"review_required","risk_level":"high","required_checks":["reputation_signal_audit","tool_install_approval_gate","customer_data_boundary_check","action_evidence_required"]}},"example_c_memory_backed_payment":{"input":{"price":"0.10 USDC","purpose":"Pay for a vendor report based on previously stored approval memory","agent_id":"agent_001","resource_url":"https://api.vendor.example/paid-report","risk_context":{"uses_memory":true,"requires_payment":true,"memory_affects_payment":true,"affects_customer_record":false},"resource_type":"memory_backed_payment"},"expected_output":{"decision":"review_required","risk_level":"medium","required_checks":["memory_use_permission_check","memory_provenance_receipt","budget_policy_memory_guard","payment_decision_memory_attribution","payment_evidence_required"]}}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.03","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_rkTduJJ_P3BDfClipS4oN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Reviews an AI agent's intent to pay for a web resource, API, or data asset, returning a structured decision with budget checks, resource binding validation, duplicate payment risk assessment, and evidence receipt guidance before any payment is authorized.","exampleAgentPrompt":"Before paying $0.03 USDC via x402 for that premium report at https://example.com/premium/report, run a pre-payment review for agent agent_demo_001 to check budget status, resource binding, and duplicate payment risk — I want the review_id and recommended next step before we proceed.","exampleUseCases":[{"title":"Pre-payment audit for paid API","prompt":"My agent is about to spend $0.10 USDC on a call to a premium data API at https://api.example.com/market-data — before it goes through, run a full pre-payment review for agent agent_prod_007 and tell me the decision, risk level, and whether there's any duplicate payment risk from a previous call this session."},{"title":"Validate x402 resource binding","prompt":"Agent agent_research_42 wants to pay for a locked article at https://content.example.com/exclusive/analysis via x402, but I need to confirm the resource binding is legitimate and the URL actually resolves to what we expect before authorizing any spend — can you run the review and give me the recommended next step?"},{"title":"Block duplicate payment for tool","prompt":"Before agent agent_ops_015 pays again for that premium GitHub repository access it may have already purchased earlier today, check for duplicate payment risk and validate our current budget policy — I don't want to be charged twice, so give me the review_id and the decision before anything is authorized."}],"resultDescription":"Returns a review_id, a decision (e.g. review_required), and a detailed resource_control object covering budget_status, metadata_privacy, resource_binding, fulfillment_check, duplicate_payment_risk, reconciliation_required, and evidence_receipt_required. Also includes before_payment and after_payment agent_guidance checklists, evidence_fields to record, and a recommended_next_step string. The response is marked experimental.","failureModes":["Missing or invalid resource_url results in a rejected review","Unknown agent_id may produce budget_status as not_checked rather than a real budget figure","Unrecognized payment_protocol (non-x402) may cause incomplete resource_binding assessment","Malformed expected_result field causes fulfillment_check to be inconclusive","Service unavailable on Render cold-start, resulting in timeout or 503"],"whenToPreferThis":"Use this endpoint when an AI agent is about to spend money on a paid web resource, API call, or data asset via x402 and you need a structured pre-authorization review — covering duplicate payment detection, budget validation, resource binding confirmation, and evidence receipt planning — before the payment is executed. Prefer this over no-op checks or manual review when operating autonomous agents that must maintain auditability of their financial actions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:37:54.117Z","isFirstParty":false}