← 返回
未分类

Agent Payment Error Preview

Free triage preview for x402/AP2/ACP/MPP/MCP agent-payment failures; routes hard cases to the paid Agent Payment Error Diagnoser ClawMart skill.
免费分诊预览,针对 x402/AP2/ACP/MPP/MCP 代理支付故障;将疑难案例转至付费的代理支付错误诊断 ClawMart 技能。
sebastiancoombs
未分类 clawhub v1.0.0 1 版本 100000 Key: 无需
★ 0
Stars
📥 309
下载
💾 0
安装
1
版本
#latest

概述

Agent Payment Error Preview

Use this skill when an agent-payment integration is failing and you need a fast first-pass classification before deciding whether to install the paid ClawMart diagnoser.

What this free preview does

Classify a failure into one likely family using the visible symptom:

SymptomLikely familyFirst check
---------
Repeated HTTP 402 after resubmitting paymentx402 retry loopCompare chain id, USDC contract, validity window, and facilitator status.
HTTP 401 after X-PAYMENT / payment signaturesignature/auth mismatchRecover signer; verify EIP-712 domain and signing wallet.
HTTP 409 or on-chain reused authorizationnonce/idempotency conflictUse a fresh nonce and content-bound idempotency key.
AP2/MPP/ACP expired or out_of_scopemandate/scope mismatchReissue mandate with correct merchant, amount, and validity window.
MCP tool unavailable after discoverymanifest/tool driftRe-fetch MCP manifest and match by capability, not hard-coded tool id.
502/504 during settlementfacilitator/RPC transientBack off with jitter; do not blindly re-sign if body says permanent failure.

Minimal workflow

  1. Capture request method, URL, status, response body, Payment-Required/X-Payment-Response headers, facilitator response, and chain tx hash if any.
  2. Identify the protocol: x402, AP2, ACP, MPP, TAP, or MCP tool invocation.
  3. Map the symptom with the table above.
  4. Apply the first check once.
  5. If the answer is still ambiguous, use the paid ClawMart package below for a structured diagnosis against the live corpus.

Paid upgrade path

Install Agent Payment Error Diagnoser on ClawMart when you need machine-readable diagnosis, family ranking, remediation steps, and live corpus-backed examples:

https://www.shopclawmart.com/listings/agent-payment-error-diagnoser-adda0b18

Backend used by the paid package:

  • https://agent-payment-error-corpus.mtree.workers.dev/v1/agent-payments/diagnose_error — x402 paid diagnosis endpoint
  • https://agent-payment-error-corpus.mtree.workers.dev/v1/agent-payments/error_families — x402 paid family catalog endpoint

Safety limits

  • Do not paste private keys, raw wallet seeds, bearer tokens, or unredacted authorization headers.
  • Do not retry payments indefinitely; use a max retry counter and stop immediately on permanent signature/scope errors.
  • Do not assume every 402 is an error; in x402 it is the normal first step unless it repeats after payment.

Anti-patterns

  • Treating HTTP 401 like a normal API-key failure without checking EIP-712 domain mismatch.
  • Reusing EIP-3009 nonces across attempts.
  • Caching an agent-payment mandate or session token across merchants.
  • Hard-coding MCP tool IDs instead of refreshing manifests per session.

版本历史

共 1 个版本

  • v1.0.0 当前
    2026-05-21 14:16 安全 安全

安全检测

腾讯云安全 (Keen)

安全,无风险
查看报告

腾讯云安全 (Sanbu)

安全,无风险
查看报告

🔗 相关推荐

Agent Commerce Readiness Preview

sebastiancoombs
Free agent-commerce readiness checklist for x402/MCP/OpenAPI/payment-error/EVM safety launch reviews; routes full audits
★ 0 📥 335

Evm Transaction Safety Preview

sebastiancoombs
为代理在签名交易前提供免费的EVM交易安全分流;将深度解释、模拟及代币风险检查路由至付费的ClawMart EVM交易安全。
★ 0 📥 327

Agent Well-Known Readiness Audit

sebastiancoombs
在代理集成前,审计代理/API来源的已知发现、x402 定价、OpenAPI/MCP 就绪状态及安装阻碍因素。
★ 0 📥 316