{
  "slug": "stripe-v2-payout-methods-add-currency-specific-payout-accounts-7a1529a6a1e8",
  "title": "Stripe v2 Payout Methods add currency-specific payout accounts",
  "tools": [
    "stripe"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-03-25T00:00:00.000Z",
  "announced_at": "2026-03-25T00:00:00.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When creating v2 Payout Method credentials, include the required `currency` value. For GB bank accounts, use `sort_code` and `account_number` for GBP, or `iban` for non-GBP; use one Payout Method per accepted currency.",
    "examples": [
      "curl -X POST https://api.stripe.com/v2/core/vault/gb_bank_accounts \\\n  -H \"Authorization: Bearer <YOUR_SECRET_KEY>\" \\\n  -H \"Stripe-Version: 2026-03-25.preview\" \\\n  --json '{\"currency\":\"gbp\",\"sort_code\":\"<sort_code>\",\"account_number\":\"<account_number>\"}'",
      "curl -X POST https://api.stripe.com/v2/core/vault/gb_bank_accounts \\\n  -H \"Authorization: Bearer <YOUR_SECRET_KEY>\" \\\n  -H \"Stripe-Version: 2026-03-25.preview\" \\\n  --json '{\"currency\":\"<non-GBP currency>\",\"iban\":\"<iban>\"}'"
    ],
    "gotchas": [
      "Version: 2026-03-25.preview",
      "Availability: Preview API version 2026-03-25.preview.",
      "currency (required): Currency of the bank account; specify the payout currency.",
      "sort_code: GB bank account sort code; release note says required for GBP accounts.",
      "account_number: GB bank account number; release note says required for GBP accounts.",
      "iban: IBAN for a GB bank account; release note says use for non-GBP currencies.",
      "supported_currencies: Response array listing currencies supported by the GB bank account.",
      "Prerequisite: Authenticate with a Stripe secret key and send the `Stripe-Version: 2026-03-25.preview` header, as shown in the versioned endpoint example.",
      "Each Payout Method supports only one currency; create a separate object for each supported currency.",
      "v2 money movement flows such as OutboundPayments, OutboundTransfers, and InboundTransfers don't support multicurrency PayoutMethods; use them only with PayoutMethods set up with the local currency.",
      "For GB Bank Accounts, include either only `iban` or both `sort_code` and `account_number`, depending on the currency.",
      "The `supported_currencies` property is a single-element array containing the currency specified in `currency`.",
      "Creating v2 Payout Method credentials without `currency` will fail."
    ]
  },
  "why_it_matters": "Update an integration that creates v2 Payout Methods to accept payouts in a specified currency, including for GB bank accounts.",
  "before": "Previously, v2 Payout Methods could receive payouts only in the bank account's local currency (or USD for US-issued debit cards).",
  "sources": [
    "https://docs.stripe.com/changelog/dahlia/2026-03-25/multicurrency-v2-payout-methods",
    "https://docs.stripe.com/api/v2/core/vault/gb-bank-accounts/create?api-version=2026-03-25.preview"
  ],
  "rank": 0.96025,
  "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-9417bb24522e29ea-0:gate",
    "evidence_hash": "48571b76c66b29b652fe1c90015d3d6ec189f8604718a6454147ce3d20fa341d"
  },
  "review": {
    "draft_hash": "f1e348d282e78899ab0575f3128a806a51c5467be4be47b5e0afb5dea4401909",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1b-tools-20261017:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.96 >= 0.9; 2 needed) and Jev gave 0.75 (>= 0.6 needed)."
  }
}