{
  "schema": "varexis-public-evidence-record/0.3",
  "generated_at_utc": "2026-10-18T16:14:30.674Z",
  "record_id": "VXI-EXT-PROCUREMENT-SQUARE-PAYMENT-VERSION-TOKEN-AMENDMENT-RACE-01-v1",
  "record_kind": "external_reference",
  "title": "Square: Payment amendments need version reconciliation",
  "system": "Square",
  "evidence_family": "vendor_evidence_review",
  "index_status": "PUBLIC_SAFE_SOURCE_REVIEW",
  "evidence_state": "PRIMARY_DOCUMENTATION_REVIEW_ONLY",
  "canonical_question": "Does a Square payment update protect an agent from overwriting another concurrent amendment?",
  "near_questions": [
    "How can Square reject a stale payment amendment?",
    "Does a completed payment support UpdatePayment?",
    "Which capability fields govern amount changes?",
    "What ties an approved amendment to a payment version?"
  ],
  "supported_claims": [
    {
      "claim": "Payment updates are last-write-wins by default. The optional version_token enables optimistic concurrency. Only eligible APPROVED payments and permitted fields can be updated; the payment capabilities and capture/cancel deadline constrain available changes.",
      "reliance": "DOCUMENTED_CAPABILITY_ONLY"
    }
  ],
  "not_demonstrated_claims": [
    "Spending approval, settlement verification or prevention of every concurrent payment change",
    "Buyer deployment testing, live runtime enforcement, certification or permission to act",
    "Expanded capabilities or licences for the existing Tool Admission and Audit Coverage executables"
  ],
  "public_summary": "Payment updates are last-write-wins by default. The optional version_token enables optimistic concurrency. Only eligible APPROVED payments and permitted fields can be updated; the payment capabilities and capture/cancel deadline constrain available changes.",
  "related_record_ids": [],
  "source_review": {
    "source_type": "official_external_documentation",
    "source_title": "Update Payment and Tip Amounts",
    "source_url": "https://developer.squareup.com/docs/payments-api/update-payments",
    "checked_on": "2026-10-18",
    "candidate_record_id": "VXI-EXT-PROCUREMENT-SQUARE-PAYMENT-VERSION-TOKEN-AMENDMENT-RACE-01-v1",
    "candidate_record_sha256": "60094c7e5dcd3b27b6f18096165031f505cfddffb80bcd670280c39721fe1305",
    "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": "Payment updates are last-write-wins by default. The optional version_token enables optimistic concurrency. Only eligible APPROVED payments and permitted fields can be updated; the payment capabilities and capture/cancel deadline constrain available changes.",
    "required_buyer_context": "Approved payment and capability fields. Reviewed version_token and proposed fields. Update result and final payment version. 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-18",
    "claim_to_check": "Does a Square payment update protect an agent from overwriting another concurrent amendment?",
    "documented_statement": {
      "status": "documented",
      "statement": "Payment updates are last-write-wins by default. The optional version_token enables optimistic concurrency. Only eligible APPROVED payments and permitted fields can be updated; the payment capabilities and capture/cancel deadline constrain available changes.",
      "source_ids": [
        "square-update"
      ]
    },
    "buyer_evidence_required": [
      "Approved payment and capability fields.",
      "Reviewed version_token and proposed fields.",
      "Update result and final payment version."
    ],
    "review_condition": {
      "status": "varexis_review_policy",
      "statement": "Do not treat an unversioned update as evidence that no concurrent terms were overwritten."
    },
    "unknowns": "The buyer configuration, contract, effective entitlement and operational evidence have not been inspected. Missing evidence does not establish absence or failure of the feature.",
    "evidence_sources": [
      {
        "source_id": "square-update",
        "url": "https://developer.squareup.com/docs/payments-api/update-payments",
        "final_url": "https://developer.squareup.com/docs/payments-api/update-payments",
        "title": "Update Payment and Tip Amounts",
        "checked_on": "2026-10-18",
        "captured_at_utc": "2026-10-18T16:08:52.048Z",
        "version_context": "Rolling official documentation captured on 2026-10-18; feature and deployment limits apply",
        "sha256": "2844ba24db0ec419187d243125c305fe80ea85049a975ba414ea75fde461da07",
        "bytes": 293165,
        "hash_basis": "Decoded HTTP response body bytes; identifies captured content, not truth or certification",
        "reviewed_sections": [
          "Does a Square payment update protect an agent from overwriting another concurrent amendment?"
        ]
      }
    ],
    "observed_deployment": false,
    "commercial_reliance_boundary": "Procurement evidence support only; no supplier clearance, legal conclusion, configuration audit or verification of the buyer's claim is supplied.",
    "paid_value": {
      "decision_context": "Bind a reviewed amount amendment to the exact payment version.",
      "free": "Complete review, practical questions, sources 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": "Approved payment and capability fields. Reviewed version_token and proposed fields. Update result and final payment version."
    },
    "buyer_relevance": "Bind a reviewed amount amendment to the exact payment version.",
    "refusal_conditions": [
      "Do not treat an unversioned update as evidence that no concurrent terms were overwritten."
    ]
  },
  "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": "Bind a reviewed amount amendment to the exact payment version.",
    "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#square-payment-version-token-amendment-race",
  "machine_readable_record": "/varexis-index/records/square-payment-version-token-amendment-race.json"
}