{
  "schema": "varexis-public-evidence-record/0.3",
  "generated_at_utc": "2026-10-24T18:06:09.388Z",
  "record_id": "VXI-EXT-PROCUREMENT-STRIPE-WEBHOOK-RAW-BODY-SIGNATURE-BOUNDARY-01-v1",
  "record_kind": "external_reference",
  "title": "Stripe raw-body signature verification",
  "system": "Stripe",
  "evidence_family": "vendor_evidence_review",
  "index_status": "PUBLIC_SAFE_SOURCE_REVIEW",
  "evidence_state": "PRIMARY_DOCUMENTATION_REVIEW_ONLY",
  "canonical_question": "Can a parsed and reserialized Stripe webhook body be substituted for the original bytes during signature verification?",
  "near_questions": [
    "Why can JSON parsing break Stripe signature verification?",
    "Can a CLI webhook secret verify a different endpoint?",
    "Which bytes must Stripe webhook verification use?",
    "Does a valid webhook signature prove fulfilment completed?"
  ],
  "supported_claims": [
    {
      "claim": "Stripe requires the unmodified raw request body for webhook signature verification. Framework parsing or other changes can cause verification to fail. Verification also depends on the correct endpoint signing secret; a CLI listener secret is distinct from the Dashboard endpoint’s secret.",
      "reliance": "DOCUMENTED_CAPABILITY_ONLY"
    }
  ],
  "not_demonstrated_claims": [
    "Payment completion or fulfilment merely from a valid signature",
    "The buyer’s middleware and secret selection are not inspected.",
    "Buyer deployment testing, live runtime enforcement, certification or permission to act",
    "Expanded capabilities or licences for existing INDEX executables"
  ],
  "public_summary": "Stripe requires the unmodified raw request body for webhook signature verification. Framework parsing or other changes can cause verification to fail. Verification also depends on the correct endpoint signing secret; a CLI listener secret is distinct from the Dashboard endpoint’s secret.",
  "related_record_ids": [],
  "source_review": {
    "source_type": "official_external_documentation",
    "source_title": "Manage webhook endpoints",
    "source_url": "https://docs.stripe.com/events/manage-webhook-endpoints.md",
    "checked_on": "2026-10-24",
    "candidate_record_id": "VXI-EXT-PROCUREMENT-STRIPE-WEBHOOK-RAW-BODY-SIGNATURE-BOUNDARY-01-v1",
    "candidate_record_sha256": "fef0f696afda9e3b8afb7c2a8cc1fde32c3f56f7e6202185c504471dbb03b22a",
    "method": "Primary documentation reviewed for the published bounded statement.",
    "deployment_tested_by_varexis": false,
    "revalidation": "The delivered snapshot preserves the review date shown. Recheck current primary documentation and deployment context before relying on present applicability; payment does not trigger fresh research."
  },
  "answer_policy": {
    "classification": "DOCUMENTED_WITH_DEPLOYMENT_BOUNDARY",
    "bounded_answer": "Stripe requires the unmodified raw request body for webhook signature verification. Framework parsing or other changes can cause verification to fail. Verification also depends on the correct endpoint signing secret; a CLI listener secret is distinct from the Dashboard endpoint’s secret.",
    "required_buyer_context": "Raw request bytes and Stripe-Signature header; Correct endpoint secret configuration; Verification outcome before processing. Buyer deployment not inspected.",
    "missing_evidence": "A broader claim needs evidence matching the intended use. Payment does not upgrade the evidence state."
  },
  "private_boundary": "Raw logs, thresholds, private paths, source code, protected mechanisms and reconstruction-level details are excluded from public and paid delivery.",
  "decision_profile": {
    "schema": "varexis-vendor-evidence-review/1",
    "review_status": "documentation_review_only",
    "checked_on": "2026-10-24",
    "claim_to_check": "Can a parsed and reserialized Stripe webhook body be substituted for the original bytes during signature verification?",
    "documented_statement": {
      "status": "documented",
      "statement": "Stripe requires the unmodified raw request body for webhook signature verification. Framework parsing or other changes can cause verification to fail. Verification also depends on the correct endpoint signing secret; a CLI listener secret is distinct from the Dashboard endpoint’s secret.",
      "source_ids": [
        "stripe-management-public"
      ]
    },
    "review_inference": {
      "status": "review_inference",
      "statement": "Preserve the original body through verification and bind the secret to the actual endpoint.",
      "source_ids": [
        "stripe-management-public"
      ]
    },
    "buyer_evidence_required": [
      "Raw request bytes and Stripe-Signature header",
      "Correct endpoint secret configuration",
      "Verification outcome before processing"
    ],
    "review_condition": {
      "status": "varexis_review_policy",
      "statement": "Refuse processing when authenticity cannot be established over the original body."
    },
    "unknowns": "The buyer’s middleware and secret selection are not inspected.",
    "unknown_finding": {
      "status": "unknown",
      "statement": "The buyer’s middleware and secret selection are not inspected."
    },
    "evidence_sources": [
      {
        "source_id": "stripe-management-public",
        "url": "https://docs.stripe.com/events/manage-webhook-endpoints.md",
        "final_url": "https://docs.stripe.com/events/manage-webhook-endpoints.md",
        "status": 200,
        "captured_at_utc": "2026-10-24T17:47:37.201Z",
        "sha256": "bc4e767212287c70fd145b008fab46332d74a72f84220f8d4f267a6170a8c870",
        "bytes": 27630,
        "title": "Manage webhook endpoints",
        "hash_basis": "Decoded HTTP response body bytes",
        "rights_review": "Factual paraphrase and source metadata only; raw source retained privately and not redistributed.",
        "checked_on": "2026-10-24",
        "capture_status": 200,
        "claim_review_completed": true,
        "reviewed_sections": [
          "Handle duplicate events",
          "Verify signatures using raw body",
          "Roll endpoint signing secrets"
        ],
        "version_context": "Official Stripe documentation captured 24 October 2026 via public Markdown after CLI documentation access returned 403; v1 Event schema or thin-event distinctions are stated per record, not a blanket API-version claim."
      }
    ],
    "observed_deployment": false,
    "commercial_reliance_boundary": "Documentation review only; the buyer must establish applicability and actual outcomes. INDEX does not inspect or control the deployment.",
    "paid_value": {
      "decision_context": "Prevent middleware changes from invalidating payment-event verification.",
      "free": "Complete review, sources, practical questions and limitations; may be saved locally.",
      "single_request": "Existing server-saved version-bound route snapshot for later authenticated retrieval.",
      "evidence_receipt": "The same snapshot plus the existing unsigned delivery receipt.",
      "excluded": [
        "Fresh vendor research",
        "Continuous monitoring or change alerts",
        "Testing the buyer configuration",
        "Private evidence or vendor certification"
      ],
      "integrity": "Hashes identify content versions; they do not prove truth or provide a signature."
    },
    "revalidation": {
      "trigger": "A saved purchase does not recheck the source or buyer configuration.",
      "specific_watch": "Recheck the documented behavior, product version and buyer evidence before relying on a current outcome."
    },
    "buyer_relevance": "Prevent middleware changes from invalidating payment-event verification.",
    "refusal_conditions": [
      "Refuse processing when authenticity cannot be established over the original body."
    ]
  },
  "niche": {
    "niche_id": "agent-authority-action-evidence",
    "label": "Agent Authority & Action Evidence",
    "classification_id": "payments",
    "classification_label": "Agent Payments, Authority & Transaction Evidence",
    "topic_id": "payments",
    "buyer_intent": "Prevent middleware changes from invalidating payment-event verification.",
    "comparison_role": "supplementary_discovery"
  },
  "paid_access_note": "The full published answer and boundaries are free. Paid access saves the selected route and source versions, with an unsigned receipt when purchased. Preview coverage before paying. Fresh research, bespoke assessment and protected evidence are excluded.",
  "service_route": {
    "request_guide": "/varexis-index/request.html",
    "request_workflow": "/varexis-index/request-workflow.json",
    "service_id": "single_request",
    "service_routes_url": "/varexis-index/service-routes.json",
    "payment_required": true,
    "availability_endpoint": "/api/index/capabilities",
    "operational_status": "AUTOMATIC_SERVICE_CAPABILITIES_GATED",
    "checkout_url": "/index-access"
  },
  "authority_boundary": "VAREXIS-INDEX informs evidence reliance. It does not provide advice, certification, deployment authority, security assurance, production approval, or guarantee.",
  "human_page": "/varexis-index/catalog.html#stripe-webhook-raw-body-signature-boundary",
  "machine_readable_record": "/varexis-index/records/stripe-webhook-raw-body-signature-boundary.json"
}
