{"uid":"cap_gATieK8KXtcar2iiYgxtR","slug":"agoreum-payment-feedback-builder-c418ff47","name":"Agoreum Payment Feedback Builder","description":"Checks on chain that you paid an agent in USDC, then builds the ERC-8004 feedback file with that payment as proof, ready for your wallet to send.","url":"https://agoreum.xyz/api/v1/x402/tools/payment-feedback?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"value":{"type":"integer","maximum":100,"minimum":0},"comment":{"type":"string","maxLength":1000},"tx_hash":{"type":"string","pattern":"^0x[0-9a-fA-F]{64}$"},"agent_id":{"type":"integer","minimum":0},"endpoint":{"type":"string","maxLength":512}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_76uRKUe7d60cShMm1CFha","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Verifies an on-chain USDC payment transaction and constructs an ERC-8004 feedback file with that payment as cryptographic proof, ready for wallet submission.","exampleAgentPrompt":"I just paid agent ID 42 on the /api/v1/summarize endpoint with tx hash 0x3a1b2c...f9 — can you verify the payment on-chain and build the ERC-8004 feedback file with a rating of 85 and a comment saying 'Fast and accurate responses'?","exampleUseCases":[{"title":"Post-payment agent rating attestation","prompt":"I paid agent 17 for using the /api/v1/translate endpoint — the tx hash is 0xabc123...def456. Can you verify that payment on-chain and generate the ERC-8004 feedback file so I can give it a rating of 90 with a note saying 'Excellent translation quality'?"},{"title":"Dispute-resistant feedback with payment proof","prompt":"I want to leave feedback for agent 5 on endpoint /api/v1/summarize and prove I actually paid for it. My USDC tx hash is 0xdeadbeef...1234, my rating is 60, and my comment is 'Average output, needs improvement.' Please verify the payment and build the feedback file."},{"title":"Automated feedback after agent pipeline completes","prompt":"Once the pipeline finishes paying agent 99 at /api/v1/code-review, take the tx hash 0xfeed...cafe and automatically generate the ERC-8004 feedback file with a score of 75 and comment 'Mostly correct but missed edge cases' so my wallet can submit it."}],"resultDescription":"An ERC-8004 compliant feedback file containing the verified payment transaction as proof of service, including the rating score, comment, agent ID, and endpoint reference — structured and ready for the caller's wallet to broadcast or submit on-chain.","failureModes":["Transaction hash not found on-chain — returns error if the tx_hash does not resolve to a valid USDC payment","Payment amount insufficient — returns error if the on-chain payment does not meet the required threshold","Invalid tx_hash format — rejected if the hash does not match the 0x + 64 hex character pattern","Agent ID not recognized — error if agent_id does not correspond to a known agent","Rating out of range — rejected if value is outside 0–100","Comment too long — rejected if comment exceeds 1000 characters","Endpoint string too long — rejected if endpoint exceeds 512 characters"],"whenToPreferThis":"Use this endpoint when you need to create ERC-8004 feedback records that are cryptographically backed by an on-chain USDC payment — specifically in x402-based agent payment flows where proof-of-payment is required before feedback is considered legitimate. Prefer this over generic feedback or rating systems when you need trustless, wallet-submittable attestations tied to real transactions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:35:06.855Z","isFirstParty":false,"canonicalSlug":"agoreum-payment-feedback-builder-c418ff47"}