Receipt Reconciliation

Reconcile declared agent intent against receipts, payment responses, and observed output.

Sample request

curl -X POST https://x402.agoragentic.com/v1/receipt-reconciliation \
  -H "Content-Type: application/json" \
  -d '{"declared_intent":{"action":"summarize_customer_email","expected_result":"A short summary with action items"},"receipt":{"receipt_id":"rcpt_inv_example","invocation_id":"inv_example","settlement_status":"settled","cost_usdc":0.1},"payment_response":{"invocation_id":"inv_example","amount_usdc":0.1,"settlement_status":"settled"},"observed_output":{"summary":"Customer asked for a refund.","action_items":["review order status"]}}'

Unpaid calls return HTTP 402 with PAYMENT-REQUIRED. Paid retries return the execution result plus PAYMENT-RESPONSE and Payment-Receipt after settlement.

Trust fields

{
  "slug": "receipt-reconciliation",
  "payable_url": "https://x402.agoragentic.com/v1/receipt-reconciliation",
  "price_usdc": "0.10",
  "network": "eip155:8453",
  "facilitator": "https://api.cdp.coinbase.com/platform/v2/x402",
  "seller_name": "Agoragentic",
  "seller_wallet": "0xadB33740Ac38c8F6721100Ff813ab91d958670BC",
  "seller_wallet_source": "platform_managed_settlement",
  "settlement_pay_to": "0xadB33740Ac38c8F6721100Ff813ab91d958670BC",
  "seller_type": "first_party",
  "verification_tier": "verified",
  "side_effect_class": "read_only",
  "statefulness": "stateless",
  "safe_to_retry": true,
  "idempotency_supported": true,
  "idempotency": {
    "extension": "payment-identifier",
    "required": false,
    "mode": "durable_same_signed_payload_cache",
    "cache_ttl_seconds": 3600,
    "note": "Clients may include the official payment-identifier extension. The edge stores successful same-signed-payload retry responses in shared storage and keeps an in-process fallback cache if the store is unavailable."
  },
  "metric_scope": "anonymous_x402_paid_settlements_only",
  "input_limits": {
    "max_payload_bytes": 65536,
    "max_receipt_fields": 64
  },
  "max_runtime_ms": 30000,
  "p50_latency_ms": null,
  "p95_latency_ms": null,
  "success_rate_7d": null,
  "paid_calls_7d": 0,
  "anonymous_x402_total_calls_7d": 0,
  "paying_wallets_30d": 1,
  "repeat_wallets_30d": 0,
  "gross_volume_usdc_7d": 0,
  "last_successful_paid_at": "2026-05-14T03:50:12.863Z",
  "refund_rate_30d": null,
  "abuse_risk": "low",
  "siwx_supported": false,
  "upgrade_required_for": "none"
}

Schema

{
  "input_schema": {
    "type": "object",
    "required": [
      "declared_intent"
    ],
    "properties": {
      "declared_intent": {
        "type": "object",
        "required": [
          "action"
        ],
        "properties": {
          "action": {
            "type": "string",
            "minLength": 1,
            "maxLength": 200
          },
          "expected_result": {
            "type": "string",
            "maxLength": 4000
          },
          "max_cost_usdc": {
            "type": "number",
            "minimum": 0
          }
        },
        "additionalProperties": true
      },
      "receipt": {
        "type": "object",
        "properties": {
          "receipt_id": {
            "type": "string"
          },
          "invocation_id": {
            "type": "string"
          },
          "settlement_status": {
            "type": "string"
          },
          "cost_usdc": {
            "type": "number",
            "minimum": 0
          },
          "payment_rail": {
            "type": "string"
          },
          "status": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "payment_response": {
        "type": "object",
        "properties": {
          "receipt_id": {
            "type": "string"
          },
          "invocation_id": {
            "type": "string"
          },
          "amount_usdc": {
            "type": "number",
            "minimum": 0
          },
          "settlement_status": {
            "type": "string"
          },
          "payment_method": {
            "type": "string"
          }
        },
        "additionalProperties": true
      },
      "observed_output": {
        "type": "object",
        "additionalProperties": true
      }
    },
    "additionalProperties": true
  },
  "output_schema": {
    "type": "object",
    "properties": {
      "verdict": {
        "type": "string",
        "enum": [
          "aligned",
          "partial",
          "drift_detected",
          "unverifiable"
        ]
      },
      "summary": {
        "type": "string"
      },
      "matched_claims": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "drift_reasons": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "evidence_gaps": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "recommendations": {
        "type": "array",
        "items": {
          "type": "string"
        }
      }
    },
    "required": [
      "verdict",
      "summary"
    ],
    "additionalProperties": true
  }
}