{
  "slug": "stripe-v2-payout-methods-can-be-disabled-for-outbound-money-movement-b88a4cb8ffc9",
  "title": "Stripe v2 Payout Methods can be disabled for outbound money movement",
  "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 processing v2 Payout Methods for payments or transfers, handle `usage_status` values including `disabled`. To stop outbound use, disable the Payout Method; to re-enable it, create a new Outbound Setup Intent.",
    "gotchas": [
      "usage_status: Object indicating whether the Payout Method meets requirements for outbound money movement. The retrieved object example shows `payments` and `transfers` values as `eligible`. The docs page did not expose the allowed values for these sub-keys.",
      "Payout Method disable endpoint (required): `POST /v2/money_management/payout_methods/:id/disable`; endpoint parameters and runnable example were not accessible in the official docs page.",
      "A disabled payout method is unavailable for outbound money movement.",
      "The disabled status is non-terminal; re-enabling requires creating a new Outbound Setup Intent.",
      "Integrations that do not handle usage_status=disabled for payments and transfers might experience unexpected failures."
    ]
  },
  "why_it_matters": "When maintaining an integration that uses v2 Payout Methods for outbound payments or transfers, handle payout methods whose usage_status is disabled.",
  "sources": [
    "https://docs.stripe.com/changelog/dahlia/2026-08-26/disable-payout-methods",
    "https://docs.stripe.com/api/v2/money-management/payout-methods/object?api-version=2026-08-26.preview",
    "https://docs.stripe.com/api/v2/money-management/payout-methods?api-version=2026-08-26.preview"
  ],
  "rank": 0.90031,
  "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-4e9e3d1f64d3deb4-0:gate",
    "evidence_hash": "3eab06576410effa5555a1bf718cb259361b32f93187b676ad86329736a1b220"
  },
  "review": {
    "draft_hash": "251fb9d6ac7720d7c52de80014dba31eba4bb45e09b74a9b8c2c28f9b7e5ced8",
    "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.90 >= 0.9; 2 needed) and Jev gave 0.64 (>= 0.6 needed)."
  }
}