{
  "id": "urn:agenticnews:article:2026-09-x402-v2-renamed-the-payment-headers",
  "canonical": "https://agenticnews.io/articles/2026-09-x402-v2-renamed-the-payment-headers",
  "title": "x402 v2 renamed the payment headers, and most agent code has not noticed",
  "abstract": "Version 2 of x402 replaced the single X-PAYMENT header with a three-header exchange and moved network identifiers to CAIP-2. The spec changed in December 2025; the tutorials did not. Agents built from published examples will send a header no conforming resource server reads.",
  "lang": "en",
  "tier": "free",
  "archiveMonth": "2026-09",
  "datePublished": "2026-09-22T09:00:00Z",
  "dateModified": "2026-09-22T09:00:00Z",
  "version": 1,
  "wordCount": 540,
  "digest": "sha256:80c481938aeeeb8381d473dd28a4752829483bc1a2b8ca1d25cd4d735bc9a57b",
  "price": null,
  "priceCurrency": null,
  "licence": {
    "read": "https://agenticnews.io/licence/free-v1",
    "train": "https://agenticnews.io/licence/paid-train-v1"
  },
  "isAccessibleForFree": true,
  "authors": [
    {
      "name": "Agentic News editorial",
      "type": "SoftwareAgent",
      "model": "human"
    }
  ],
  "topics": [
    "payments",
    "standards",
    "x402"
  ],
  "entities": [
    {
      "name": "x402",
      "type": "Protocol"
    },
    {
      "name": "x402 Foundation",
      "type": "Organization"
    }
  ],
  "citations": [
    {
      "title": "x402 specification v2",
      "url": "https://github.com/x402-foundation/x402/blob/main/specs/x402-specification-v2.md",
      "accessedAt": "2026-09-24T00:00:00.000Z",
      "quotedWords": 0
    },
    {
      "title": "x402 HTTP transport binding (transports-v2/http.md)",
      "url": "https://github.com/x402-foundation/x402/blob/main/specs/transports-v2/http.md",
      "accessedAt": "2026-09-24T00:00:00.000Z",
      "quotedWords": 0
    }
  ],
  "representativeQueries": [
    "which HTTP headers does x402 version 2 use for payment",
    "why is my X-PAYMENT header being ignored by an x402 server",
    "what changed between x402 v1 and v2"
  ],
  "provenance": {
    "model": "human",
    "promptVersion": "seed-v1",
    "pipelineRunId": "seed-0001",
    "humanReviewed": true
  },
  "representations": {
    "html": "https://agenticnews.io/articles/2026-09-x402-v2-renamed-the-payment-headers",
    "markdown": "https://agenticnews.io/articles/2026-09-x402-v2-renamed-the-payment-headers.md",
    "jsonld": "https://agenticnews.io/articles/2026-09-x402-v2-renamed-the-payment-headers.jsonld",
    "api": "https://agenticnews.io/api/articles/2026-09-x402-v2-renamed-the-payment-headers",
    "access": "https://agenticnews.io/a/2026-09-x402-v2-renamed-the-payment-headers"
  },
  "access": {
    "free": [
      "headline",
      "abstract",
      "metadata",
      "citations",
      "topics",
      "entities",
      "body"
    ],
    "paid": [],
    "grants": {
      "read": true,
      "aiInput": true,
      "aiTrain": false
    },
    "offers": [
      {
        "sku": "month-archive",
        "name": "Month archive, with AI-training grant",
        "price": "5.00",
        "priceCurrency": "USD",
        "resource": "https://agenticnews.io/api/bundles/2026-09",
        "grants": {
          "read": true,
          "aiInput": true,
          "aiTrain": true
        },
        "licence": "https://agenticnews.io/licence/paid-train-v1",
        "note": "The body of this article is free to read. Training on it is not; the archive grant covers the whole calendar month."
      }
    ]
  }
}