{
  "slug": "stripe-payment-link-update-accepts-connect-parameters-24cc6f966411",
  "title": "Stripe Payment Link update accepts Connect parameters",
  "tools": [
    "stripe"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-08-26T00:00:00.000Z",
  "announced_at": "2026-08-26T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When updating a Payment Link used with Connect, send the supported money movement parameters to update its settings for future Checkout Sessions. Existing active sessions are unaffected.",
    "examples": [
      "curl https://api.stripe.com/v1/payment_links/<PAYMENT_LINK_ID> \\\n  -u \"<YOUR_SECRET_KEY>:\" \\\n  -H \"Stripe-Version: 2026-08-26.dahlia\" \\\n  -d \"application_fee_amount=<AMOUNT>\" \\\n  -d \"application_fee_percent=<PERCENT>\" \\\n  -d \"on_behalf_of=<CONNECTED_ACCOUNT_ID>\" \\\n  -d \"transfer_data[destination]=<CONNECTED_ACCOUNT_ID>\"",
      "curl https://api.stripe.com/v1/payment_links/<PAYMENT_LINK_ID> \\\n  -u \"<YOUR_SECRET_KEY>:\" \\\n  -H \"Stripe-Version: 2026-08-26.dahlia\" \\\n  -d \"application_fee_amount=\""
    ],
    "gotchas": [
      "Version: 2026-08-26.dahlia",
      "<PAYMENT_LINK_ID> (required): ID of the Payment Link to update.",
      "application_fee_amount: Integer fee amount transferred to the application owner; only when no line item has a recurring price. Empty string unsets it.",
      "application_fee_percent: Non-negative percentage from 0 to 100, at most two decimals; requires at least one recurring-price line item. Empty string unsets it.",
      "on_behalf_of: Account on whose behalf to charge. Empty string unsets it.",
      "transfer_data: Object specifying the account, if any, to which payments are attributed for tax reporting and where funds are transferred. Empty string unsets it; documented subkeys not found.",
      "Prerequisite: The update API reference lists a Price and an existing Payment Link as prerequisite objects; create a Price and Payment Link first if they do not already exist.",
      "Prerequisite: The changelog says REST API requests must specify Stripe-Version: 2026-08-26.dahlia to use this API version.",
      "Applies to Payment Links used with Connect.",
      "The updated configuration affects Checkout Sessions created from the Payment Link after the change; existing active sessions are unaffected."
    ]
  },
  "why_it_matters": "For a repository workflow that updates an existing Payment Link's Connect money movement configuration, modify the link and apply the updated settings to future Checkout Sessions.",
  "before": "These parameters were previously available only when creating a Payment Link.",
  "sources": [
    "https://docs.stripe.com/changelog/dahlia/2026-08-26/adds-connect-parameters-to-the-payment-link-update-method",
    "https://docs.stripe.com/api/payment-link/update?api-version=2026-08-26.dahlia"
  ],
  "rank": 0.94021,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave1b-tools-20261017",
    "verdict_id": "wave1b-tools-20261017:wave1b-tools-20261017-2e581a260d1a677c-0:gate",
    "evidence_hash": "a6343a273db6114a8c2e25039a92dd8fe4407a39e0da81787a186ceb606fd997"
  },
  "review": {
    "draft_hash": "0a26b32127dcfcd76be8b8f8e5294466b5f66175f9af565766a2971719bb1348",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-tools-20261017:gate",
    "reason": "2 of 3 judge runs approved with p_yes >= 0.9 (mean 0.94 >= 0.9; 2 needed) and Jev gave 0.73 (>= 0.6 needed)."
  }
}
