Skip to content

armgit / spree

Public Imported from GitHub
0

Open Source Platform for DTC, B2B Commerce, Marketplaces & Omnichannel. REST APIs, TypeScript SDKs, and production-ready Next.js storefront. Self-host it. Own your data. No vendor lock-in. Zero platform fees.

Ask Stripe whether a seller can be paid, and test against it

Damian Legawiec634613188c89
diff --git a/spree/providers/stripe/app/models/spree_stripe/gateway/connect.rb b/spree/providers/stripe/app/models/spree_stripe/gateway/connect.rb
index eb1142bbc1..aefa0595d6 100644
--- a/spree/providers/stripe/app/models/spree_stripe/gateway/connect.rb
+++ b/spree/providers/stripe/app/models/spree_stripe/gateway/connect.rb
@@ -65,6 +65,14 @@ module SpreeStripe
# @param return_url [String] where Stripe sends them when they finish
# @return [String] the onboarding URL
def create_connect_account_link(seller:, refresh_url:, return_url:)
+ # A marketplace usually connects Stripe long before it has any sellers,
+ # and the endpoint is registered when the gateway is saved — so by the
+ # time the first seller onboards there may be nothing listening, and
+ # the `account.updated` that says they can be paid never arrives.
+ # Asked for here because this is the moment it starts to matter.
+ ensure_connect_webhook_endpoint
+
+
account_id = payout_account_for(seller) || create_connect_account(seller).tap do |created|
seller.set_payout_account_reference(SpreeStripe::PayoutProvider, created)
end
@@ -97,7 +105,7 @@ module SpreeStripe
def create_connect_account(seller)
Stripe::Account.create(
connect_account_params(seller),
- api_options.merge(idempotency_key: "spree-seller-#{seller.prefixed_id}")
+ api_options.merge(idempotency_key: account_idempotency_key(seller))
).id
end
@@ -105,12 +113,24 @@ module SpreeStripe
country_code = seller_country_code(seller)
params = {
- type: 'express',
country: country_code,
email: seller.contact_email,
business_profile: { name: seller.name },
- # The platform pays Stripe's fees and owns the dispute relationship,
- # which is what makes this a marketplace rather than a referral.
+ # What kind of account this is, stated as the three things that
+ # actually differ rather than as a preset: the platform pays Stripe's
+ # fees and owns the dispute relationship, which is what makes this a
+ # marketplace rather than a referral, and the seller gets Stripe's
+ # own hosted dashboard.
+ #
+ # Deliberately no `type: 'express'` beside it. The two are mutually
+ # exclusive — Stripe refuses a request carrying both — and `type` is
+ # deprecated in favour of stating the properties. One consequence
+ # worth knowing: the account reads back as `type: "none"`, so nothing
+ # may branch on that field.
+ #
+ # `requirement_collection` is left unset, which defaults to `stripe`
+ # — Stripe collects what it needs through its hosted onboarding, and
+ # `application` is not even allowed alongside an Express dashboard.
controller: {
fees: { payer: 'application' },
losses: { payments: 'application' },
@@ -125,28 +145,43 @@ module SpreeStripe
metadata: { spree_seller_id: seller.id }
}
- # Paying a seller abroad is a different agreement, not a variation on
- # the domestic one: Stripe requires the recipient service agreement,
- # under which the seller may not accept card payments in their own
- # right. Without it the account cannot be created at all.
- params[:tos_acceptance] = { service_agreement: 'recipient' } if cross_border?(country_code)
-
params
end
+ # Identifies one attempt at creating this seller's account, not the seller.
+ #
+ # Two clicks a second apart must not open two Connect accounts, which is
+ # what an idempotency key is for. But Stripe caches a failed response
+ # against the key for a day, and refuses a retry whose parameters have
+ # changed — so a key that never moves means a seller who hit a bad
+ # request stays broken until tomorrow, and sees a confusing complaint
+ # about mismatched parameters rather than the real problem.
+ #
+ # Rolling on the day keeps double-submit protection where it matters
+ # while letting a fix take effect. `updated_at` moves whenever the
+ # seller record is touched, which a failed attempt does.
+ def account_idempotency_key(seller)
+ stamp = seller.updated_at.to_i
+
+ "spree-seller-#{seller.prefixed_id}-#{stamp}"
+ end
+
# Where the seller trades, which decides what currency and bank details
# their account can hold. Falls back to the marketplace's own country —
# Stripe would otherwise assume it anyway, and assuming it silently is
# how a seller ends up with an account no local bank can receive.
+ #
+ # No service agreement is sent with it. A seller abroad needs the
+ # recipient agreement only under Stripe's Global payouts product;
+ # marketplaces on Connect's own cross-border payouts need the standard
+ # one, and sending recipient there would wrongly bar the seller from
+ # taking card payments. Which product a marketplace is on cannot be read
+ # off a country code, so core sends neither and lets Stripe apply the
+ # right default.
def seller_country_code(seller)
seller.billing_address&.country_code.presence || store.default_country_code
end
- def cross_border?(country_code)
- country_code.present? && store.default_country_code.present? &&
- country_code.to_s.upcase != store.default_country_code.to_s.upcase
- end
-
# Whether Stripe will let this seller be paid. It can go back to false —
# a seller whose documents expire stops being payable, and the ledger
# must stop crediting them rather than promise money nothing can send.
@@ -241,6 +276,12 @@ module SpreeStripe
# nothing about creating a seller saves the gateway — so that guard meant
# the endpoint was never registered at all, and `account.updated` never
# arrived to say who could be paid.
+ def ensure_connect_webhook_endpoint
+ return if preferred_connect_webhook_signing_secret.present?
+
+ SpreeStripe::CreateWebhookEndpointJob.perform_later(id, connect: true)
+ end
+
def create_connect_webhook_endpoint_async
return if preferred_connect_webhook_signing_secret.present?
diff --git a/spree/providers/stripe/app/models/spree_stripe/payout_provider.rb b/spree/providers/stripe/app/models/spree_stripe/payout_provider.rb
index 9e61a4b248..8041db3adb 100644
--- a/spree/providers/stripe/app/models/spree_stripe/payout_provider.rb
+++ b/spree/providers/stripe/app/models/spree_stripe/payout_provider.rb
@@ -61,6 +61,28 @@ module SpreeStripe
refresh_url: refresh_url,
return_url: return_url
)
+ rescue Stripe::StripeError => e
+ # Core knows nothing about Stripe's exceptions, and a seller asking to
+ # set up their payouts should be told what went wrong rather than shown
+ # a crash. The provider contract speaks GatewayError.
+ raise Spree::Core::GatewayError, e.message
+ end
+
+ # Asked of Stripe rather than read from `payouts_enabled_at`.
+ #
+ # That column is a cache of what a webhook last told us, and a webhook is
+ # a thing that can fail to arrive — an endpoint not yet registered, a
+ # delivery dropped, a local tunnel that was not running. A seller who has
+ # finished onboarding then sits looking at a checklist that says they have
+ # not, while Stripe has been ready to pay them for hours.
+ #
+ # The account is fetched once per instance either way, since answering why
+ # a row is incomplete needs it too.
+ def onboarded?(seller)
+ account = retrieve_account(seller)
+ return seller.payouts_enabled? if account.nil?
+
+ account.payouts_enabled
end
# Which of the three things is true, read off the account itself.
diff --git a/spree/providers/stripe/spec/models/spree_stripe/gateway/connect_account_spec.rb b/spree/providers/stripe/spec/models/spree_stripe/gateway/connect_account_spec.rb
new file mode 100644
index 0000000000..2d3155cd15
--- /dev/null
+++ b/spree/providers/stripe/spec/models/spree_stripe/gateway/connect_account_spec.rb
@@ -0,0 +1,81 @@
+require 'spec_helper'
+
+# The Connect account contract, against Stripe rather than against a stub.
+#
+# The rest of the Connect specs stub `Stripe::Account.create` and assert on the
+# hash we were about to send, which cannot tell us whether Stripe accepts it —
+# a payload carrying both `type` and `controller` passed every one of those
+# while failing every real request. These record what Stripe actually said.
+RSpec.describe SpreeStripe::Gateway::Connect do
+ let(:store) { @default_store }
+ let(:gateway) { create(:stripe_gateway, store: store) }
+ let(:seller) { create(:seller, :approved, store: store, name: 'Sparks Audio') }
+
+ describe 'creating a seller their account' do
+ it 'opens an Express account Stripe accepts', vcr: { cassette_name: 'connect_create_express_account' } do
+ url = gateway.create_connect_account_link(
+ seller: seller,
+ refresh_url: 'https://example.test/onboarding',
+ return_url: 'https://example.test/onboarding'
+ )
+
+ expect(url).to start_with('https://connect.stripe.com/')
+ expect(seller.reload.payout_account_reference(SpreeStripe::PayoutProvider)).to start_with('acct_')
+ end
+
+ # Stripe reads the properties back rather than the preset, so the account
+ # is described by what it can do rather than by a type name.
+ it 'gives the platform the fees and the losses', vcr: { cassette_name: 'connect_create_express_account_shape' } do
+ gateway.create_connect_account_link(
+ seller: seller,
+ refresh_url: 'https://example.test/onboarding',
+ return_url: 'https://example.test/onboarding'
+ )
+
+ account = Stripe::Account.retrieve(
+ seller.reload.payout_account_reference(SpreeStripe::PayoutProvider), gateway.api_options
+ )
+
+ expect(account.controller.fees.payer).to eq('application')
+ expect(account.controller.losses.payments).to eq('application')
+ expect(account.controller.stripe_dashboard.type).to eq('express')
+ end
+
+ # Spree decides when a seller is settled, so Stripe must not also be
+ # paying their balance out on a clock of its own.
+ it 'leaves the payout schedule to Spree', vcr: { cassette_name: 'connect_create_express_account_manual_payouts' } do
+ gateway.create_connect_account_link(
+ seller: seller,
+ refresh_url: 'https://example.test/onboarding',
+ return_url: 'https://example.test/onboarding'
+ )
+
+ account = Stripe::Account.retrieve(
+ seller.reload.payout_account_reference(SpreeStripe::PayoutProvider), gateway.api_options
+ )
+
+ expect(account.settings.payouts.schedule.interval).to eq('manual')
+ end
+ end
+
+ describe 'a seller who already holds an account' do
+ it 'mints a fresh link without opening a second one', vcr: { cassette_name: 'connect_relink_existing_account' } do
+ first = gateway.create_connect_account_link(
+ seller: seller,
+ refresh_url: 'https://example.test/onboarding',
+ return_url: 'https://example.test/onboarding'
+ )
+ account_id = seller.reload.payout_account_reference(SpreeStripe::PayoutProvider)
+
+ second = gateway.create_connect_account_link(
+ seller: seller.reload,
+ refresh_url: 'https://example.test/onboarding',
+ return_url: 'https://example.test/onboarding'
+ )
+
+ expect(second).to start_with('https://connect.stripe.com/')
+ expect(second).not_to eq(first)
+ expect(seller.reload.payout_account_reference(SpreeStripe::PayoutProvider)).to eq(account_id)
+ end
+ end
+end
diff --git a/spree/providers/stripe/spec/models/spree_stripe/gateway/connect_spec.rb b/spree/providers/stripe/spec/models/spree_stripe/gateway/connect_spec.rb
index e85366bef7..0bd1dcaaa1 100644
--- a/spree/providers/stripe/spec/models/spree_stripe/gateway/connect_spec.rb
+++ b/spree/providers/stripe/spec/models/spree_stripe/gateway/connect_spec.rb
@@ -226,21 +226,26 @@ RSpec.describe SpreeStripe::Gateway::Connect do
onboard
end
- # Paying a seller abroad is a different agreement, and without it Stripe
- # refuses to create the account at all.
- it 'accepts the recipient agreement for a seller abroad' do
+ # Which service agreement a seller abroad needs depends on which payouts
+ # product the marketplace is on, which a country code cannot tell us — so
+ # core sends none and lets Stripe apply its own default.
+ it 'states no service agreement' do
new_seller.update!(billing_address: create(:address, country_code: 'FR', state_code: nil))
- expect(Stripe::Account).to receive(:create).
- with(hash_including(tos_acceptance: { service_agreement: 'recipient' }), anything).
- and_return(Stripe::StripeObject.construct_from(id: 'acct_new'))
+ expect(Stripe::Account).to receive(:create) do |params, _options|
+ expect(params).not_to have_key(:tos_acceptance)
+ Stripe::StripeObject.construct_from(id: 'acct_new')
+ end
onboard
end
- it 'does not ask for it at home' do
+ # Mutually exclusive with `controller`, and deprecated besides — sending
+ # both is a 400 that stops any seller onboarding at all.
+ it 'states the controller properties rather than an account type' do
expect(Stripe::Account).to receive(:create) do |params, _options|
- expect(params).not_to have_key(:tos_acceptance)
+ expect(params).not_to have_key(:type)
+ expect(params[:controller]).to include(stripe_dashboard: { type: 'express' })
Stripe::StripeObject.construct_from(id: 'acct_new')
end
diff --git a/spree/providers/stripe/spec/models/spree_stripe/payout_provider_spec.rb b/spree/providers/stripe/spec/models/spree_stripe/payout_provider_spec.rb
index 9db09fb286..eeaa7da0c3 100644
--- a/spree/providers/stripe/spec/models/spree_stripe/payout_provider_spec.rb
+++ b/spree/providers/stripe/spec/models/spree_stripe/payout_provider_spec.rb
@@ -128,6 +128,42 @@ RSpec.describe SpreeStripe::PayoutProvider do
end
end
+ # The column is a cache of what a webhook last said, and a webhook can fail
+ # to arrive — an endpoint never registered, a delivery dropped. A seller who
+ # has finished onboarding must not be left looking at a checklist that says
+ # they have not while Stripe is ready to pay them.
+ describe '#onboarded?' do
+ def stub_account(payouts_enabled:)
+ allow(Stripe::Account).to receive(:retrieve).and_return(
+ Stripe::StripeObject.construct_from(
+ id: 'acct_seller', payouts_enabled: payouts_enabled, requirements: { disabled_reason: nil, errors: [] }
+ )
+ )
+ end
+
+ it 'believes Stripe over a column no webhook has written' do
+ seller.update!(payouts_enabled_at: nil)
+ stub_account(payouts_enabled: true)
+
+ expect(described_class.new.onboarded?(seller)).to be(true)
+ end
+
+ it 'believes Stripe when it withdraws the capability' do
+ seller.update!(payouts_enabled_at: Time.current)
+ stub_account(payouts_enabled: false)
+
+ expect(described_class.new.onboarded?(seller)).to be(false)
+ end
+
+ # Stripe being unreachable must not read as "this seller cannot be paid".
+ it 'falls back to what we were last told when Stripe cannot be reached' do
+ seller.update!(payouts_enabled_at: Time.current)
+ allow(Stripe::Account).to receive(:retrieve).and_raise(Stripe::APIError.new('boom'))
+
+ expect(described_class.new.onboarded?(seller)).to be(true)
+ end
+ end
+
describe '#onboarding_state' do
def account(payouts_enabled:, disabled_reason: nil, errors: [])
Stripe::StripeObject.construct_from(
diff --git a/spree/providers/stripe/spec/requests/spree/api/v3/seller/payout_account_spec.rb b/spree/providers/stripe/spec/requests/spree/api/v3/seller/payout_account_spec.rb
new file mode 100644
index 0000000000..61cb754c47
--- /dev/null
+++ b/spree/providers/stripe/spec/requests/spree/api/v3/seller/payout_account_spec.rb
@@ -0,0 +1,77 @@
+require 'spec_helper'
+require 'spree/api/testing_support/v3/base'
+
+# The seller-facing endpoint, end to end and against Stripe.
+#
+# It lives in this gem rather than in spree_api because that is where both
+# halves meet: the controller comes from the API engine, the provider that
+# answers it comes from here, and only here is there a Stripe key to record
+# against. A controller spec in spree_api can only stub the provider, which
+# is what let a payload Stripe rejects pass every test it had.
+RSpec.describe 'Seller payout account', type: :request do
+ let(:store) { @default_store }
+ let!(:gateway) { create(:stripe_gateway, store: store) }
+ let(:seller) { create(:seller, :approved, store: store, name: 'Sparks Audio') }
+ let(:seller_user) do
+ create(:admin_user, :without_admin_role).tap { |user| seller.add_user(user) }
+ end
+ let(:headers) do
+ token = Spree::Api::V3::TestingSupport.generate_jwt(
+ seller_user, audience: Spree::Api::V3::JwtAuthentication::JWT_AUDIENCE_SELLER
+ )
+
+ {
+ 'Authorization' => "Bearer #{token}",
+ 'X-Spree-Seller-Id' => seller.prefixed_id,
+ 'CONTENT_TYPE' => 'application/json'
+ }
+ end
+ let(:urls) do
+ { refresh_url: 'https://example.test/onboarding', return_url: 'https://example.test/onboarding' }
+ end
+
+ before { store.update!(preferred_payout_provider: 'SpreeStripe::PayoutProvider') }
+
+ describe 'POST /api/v3/seller/onboarding/payout_account' do
+ it 'answers with somewhere the seller can finish setting up',
+ vcr: { cassette_name: 'seller_payout_account_link' } do
+ post '/api/v3/seller/onboarding/payout_account', params: urls.to_json, headers: headers
+
+ expect(response).to have_http_status(:ok)
+ expect(JSON.parse(response.body)['url']).to start_with('https://connect.stripe.com/')
+ end
+
+ it 'remembers the account it opened, so a second visit reuses it',
+ vcr: { cassette_name: 'seller_payout_account_link_records_account' } do
+ post '/api/v3/seller/onboarding/payout_account', params: urls.to_json, headers: headers
+
+ expect(seller.reload.payout_account_reference(SpreeStripe::PayoutProvider)).to start_with('acct_')
+ end
+
+ # A marketplace settling by hand has nowhere to send anybody.
+ it 'answers with no link when the store pays its sellers itself' do
+ store.update!(preferred_payout_provider: '')
+
+ post '/api/v3/seller/onboarding/payout_account', params: urls.to_json, headers: headers
+
+ expect(response).to have_http_status(:ok)
+ expect(JSON.parse(response.body)['url']).to be_nil
+ end
+
+ it 'refuses a seller who is not signed in' do
+ post '/api/v3/seller/onboarding/payout_account',
+ params: urls.to_json,
+ headers: { 'CONTENT_TYPE' => 'application/json' }
+
+ expect(response).to have_http_status(:unauthorized)
+ end
+
+ # Somebody has to say where to come back to, and core does not know the
+ # panel's routes.
+ it 'refuses a request that names nowhere to return to' do
+ post '/api/v3/seller/onboarding/payout_account', params: {}.to_json, headers: headers
+
+ expect(response).to have_http_status(:bad_request)
+ end
+ end
+end
diff --git a/spree/providers/stripe/spec/vcr/connect_create_express_account.yml b/spree/providers/stripe/spec/vcr/connect_create_express_account.yml
new file mode 100644
index 0000000000..9682686197
--- /dev/null
+++ b/spree/providers/stripe/spec/vcr/connect_create_express_account.yml
@@ -0,0 +1,343 @@
+---
+http_interactions:
+- request:
+ method: post
+ uri: https://api.stripe.com/v1/accounts
+ body:
+ encoding: UTF-8
+ string: country=US&business_profile[name]=Sparks+Audio&controller[fees][payer]=application&controller[losses][payments]=application&controller[stripe_dashboard][type]=express&capabilities[transfers][requested]=true&settings[payouts][schedule][interval]=manual&metadata[spree_seller_id]=1
+ headers:
+ User-Agent:
+ - Stripe/v1 RubyBindings/18.4.2 Spree Stripe/6.0.0.alpha (https://spreecommerce.org)
+ AIAgent/claude_code
+ Authorization:
+ - Bearer <STRIPE_SECRET_KEY>
+ X-Stripe-Client-Telemetry:
+ - '{"last_request_metrics":{"request_id":"req_7H4neBTaIIVpom","request_duration_ms":611}}'
+ Idempotency-Key:
+ - spree-seller-sel_UkLWZg9DAJ-1787840592
+ Stripe-Version:
+ - '2023-10-16'
+ X-Stripe-Client-User-Agent:
+ - "<FILTERED>"
+ Content-Type:
+ - application/x-www-form-urlencoded
+ Accept-Encoding:
+ - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+ Accept:
+ - "*/*"
+ response:
+ status:
+ code: 200
+ message: OK
+ headers:
+ Server:
+ - nginx
+ Date:
+ - Thu, 27 Aug 2026 14:23:15 GMT
+ Content-Type:
+ - application/json
+ Content-Length:
+ - '3562'
+ Connection:
+ - keep-alive
+ Access-Control-Allow-Credentials:
+ - 'true'
+ Access-Control-Allow-Methods:
+ - GET, HEAD, PUT, PATCH, POST, DELETE
+ Access-Control-Allow-Origin:
+ - "*"
+ Access-Control-Expose-Headers:
+ - Request-Id, Stripe-Manage-Version, Stripe-Should-Retry, X-Stripe-External-Auth-Required,
+ X-Stripe-Privileged-Session-Required
+ Access-Control-Max-Age:
+ - '300'
+ Cache-Control:
+ - no-cache, no-store
+ Content-Security-Policy:
+ - base-uri 'none'; default-src 'none'; form-action 'none'; frame-ancestors 'none';
+ img-src 'self'; script-src 'self' 'report-sample'; style-src 'self'; worker-src
+ 'none'; upgrade-insecure-requests; report-uri https://q.stripe.com/csp-violation?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ;
+ report-to csp
+ Idempotency-Key:
+ - spree-seller-sel_UkLWZg9DAJ-1787840592
+ Original-Request:
+ - req_nutTAGN3K4msUA
+ Report-To:
+ - '{"group":"csp","max_age":8640,"endpoints":[{"url":"https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"}],"include_subdomains":true}'
+ Reporting-Endpoints:
+ - csp="https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"
+ Request-Id:
+ - req_nutTAGN3K4msUA
+ Stripe-Notice:
+ - '2 notices for this request: (1) You are using an outdated API version (2023-10-16).
+ We recommend upgrading to the latest API version, 2026-07-29.dahlia. See https://docs.stripe.com/upgrades
+ (2) We recommend building your integration using Accounts v2. See https://docs.stripe.com/api/v2/core/accounts'
+ Stripe-Should-Retry:
+ - 'false'
+ Stripe-Version:
+ - '2023-10-16'
+ Vary:
+ - Origin
+ X-Stripe-Priority-Routing-Enabled:
+ - 'true'
+ X-Stripe-Routing-Context-Priority-Tier:
+ - api-testmode
+ X-Wc:
+ - 3c3
+ Strict-Transport-Security:
+ - max-age=63072000; includeSubDomains; preload
+ body:
+ encoding: UTF-8
+ string: |-
+ {
+ "id": "acct_1U94CyII65DRaZXS",
+ "object": "account",
+ "business_profile": {
+ "annual_revenue": null,
+ "estimated_worker_count": null,
+ "mcc": null,
+ "minority_owned_business_designation": null,
+ "name": "Sparks Audio",
+ "product_description": null,
+ "specified_commercial_transactions_act_url": null,
+ "support_address": null,
+ "support_email": null,
+ "support_phone": null,
+ "support_url": null,
+ "url": null
+ },
+ "business_type": null,
+ "capabilities": {
+ "transfers": "inactive"
+ },
+ "charges_enabled": false,
+ "controller": {
+ "fees": {
+ "payer": "application"
+ },
+ "is_controller": true,
+ "losses": {
+ "payments": "application"
+ },
+ "requirement_collection": "stripe",
+ "stripe_dashboard": {
+ "type": "express"
+ },
+ "type": "application"
+ },
+ "country": "US",
+ "created": 1787840594,
+ "default_currency": "usd",
+ "details_submitted": false,
+ "email": null,
+ "external_accounts": {
+ "object": "list",
+ "data": [],
+ "has_more": false,
+ "total_count": 0,
+ "url": "/v1/accounts/acct_1U94CyII65DRaZXS/external_accounts"
+ },
+ "future_requirements": {
+ "alternatives": [],
+ "current_deadline": null,
+ "currently_due": [],
+ "disabled_reason": null,
+ "errors": [],
+ "eventually_due": [],
+ "past_due": [],
+ "pending_verification": []
+ },
+ "login_links": {
+ "object": "list",
+ "data": [],
+ "has_more": false,
+ "total_count": 0,
+ "url": "/v1/accounts/acct_1U94CyII65DRaZXS/login_links"
+ },
+ "metadata": {
+ "spree_seller_id": "1"
+ },
+ "payouts_enabled": false,
+ "requirements": {
+ "alternatives": [],
+ "current_deadline": null,
+ "currently_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "disabled_reason": "requirements.past_due",
+ "errors": [],
+ "eventually_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "past_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "pending_verification": []
+ },
+ "settings": {
+ "bacs_debit_payments": {
+ "display_name": null,
+ "service_user_number": null
+ },
+ "branding": {
+ "icon": null,
+ "logo": null,
+ "primary_color": null,
+ "secondary_color": null
+ },
+ "card_issuing": {
+ "tos_acceptance": {
+ "date": null,
+ "ip": null
+ }
+ },
+ "card_payments": {
+ "decline_on": {
+ "avs_failure": false,
+ "cvc_failure": false
+ },
+ "statement_descriptor_prefix": "SPARKS AUD",
+ "statement_descriptor_prefix_kana": null,
+ "statement_descriptor_prefix_kanji": null
+ },
+ "dashboard": {
+ "display_name": "Sparks Audio",
+ "timezone": "Etc/UTC"
+ },
+ "invoices": {
+ "default_account_tax_ids": null,
+ "hosted_payment_method_save": "offer"
+ },
+ "payments": {
+ "statement_descriptor": "SPARKS AUDIO",
+ "statement_descriptor_kana": null,
+ "statement_descriptor_kanji": null
+ },
+ "payouts": {
+ "debit_negative_balances": true,
+ "schedule": {
+ "delay_days": 2,
+ "interval": "manual"
+ },
+ "statement_descriptor": null
+ },
+ "sepa_debit_payments": {}
+ },
+ "tos_acceptance": {
+ "date": null,
+ "ip": null,
+ "user_agent": null
+ },
+ "type": "none"
+ }
+ recorded_at: Thu, 27 Aug 2026 14:23:15 GMT
+- request:
+ method: post
+ uri: https://api.stripe.com/v1/account_links
+ body:
+ encoding: UTF-8
+ string: account=acct_1U94CyII65DRaZXS&refresh_url=https%3A%2F%2Fexample.test%2Fonboarding&return_url=https%3A%2F%2Fexample.test%2Fonboarding&type=account_onboarding
+ headers:
+ User-Agent:
+ - Stripe/v1 RubyBindings/18.4.2 Spree Stripe/6.0.0.alpha (https://spreecommerce.org)
+ AIAgent/claude_code
+ Authorization:
+ - Bearer <STRIPE_SECRET_KEY>
+ X-Stripe-Client-Telemetry:
+ - '{"last_request_metrics":{"request_id":"req_nutTAGN3K4msUA","request_duration_ms":2806}}'
+ Idempotency-Key:
+ - 7269bde9-fe16-49fe-ac0c-1361f12198dd
+ Stripe-Version:
+ - '2023-10-16'
+ X-Stripe-Client-User-Agent:
+ - "<FILTERED>"
+ Content-Type:
+ - application/x-www-form-urlencoded
+ Accept-Encoding:
+ - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+ Accept:
+ - "*/*"
+ response:
+ status:
+ code: 200
+ message: OK
+ headers:
+ Server:
+ - nginx
+ Date:
+ - Thu, 27 Aug 2026 14:23:15 GMT
+ Content-Type:
+ - application/json
+ Content-Length:
+ - '165'
+ Connection:
+ - keep-alive
+ Access-Control-Allow-Credentials:
+ - 'true'
+ Access-Control-Allow-Methods:
+ - GET, HEAD, PUT, PATCH, POST, DELETE
+ Access-Control-Allow-Origin:
+ - "*"
+ Access-Control-Expose-Headers:
+ - Request-Id, Stripe-Manage-Version, Stripe-Should-Retry, X-Stripe-External-Auth-Required,
+ X-Stripe-Privileged-Session-Required
+ Access-Control-Max-Age:
+ - '300'
+ Cache-Control:
+ - no-cache, no-store
+ Content-Security-Policy:
+ - base-uri 'none'; default-src 'none'; form-action 'none'; frame-ancestors 'none';
+ img-src 'self'; script-src 'self' 'report-sample'; style-src 'self'; worker-src
+ 'none'; upgrade-insecure-requests; report-uri https://q.stripe.com/csp-violation?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ;
+ report-to csp
+ Idempotency-Key:
+ - 7269bde9-fe16-49fe-ac0c-1361f12198dd
+ Original-Request:
+ - req_KTkzQe4eufemZs
+ Report-To:
+ - '{"group":"csp","max_age":8640,"endpoints":[{"url":"https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"}],"include_subdomains":true}'
+ Reporting-Endpoints:
+ - csp="https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"
+ Request-Id:
+ - req_KTkzQe4eufemZs
+ Stripe-Notice:
+ - You are using an outdated API version (2023-10-16). We recommend upgrading
+ to the latest API version, 2026-07-29.dahlia. See https://docs.stripe.com/upgrades
+ Stripe-Should-Retry:
+ - 'false'
+ Stripe-Version:
+ - '2023-10-16'
+ Vary:
+ - Origin
+ X-Stripe-Priority-Routing-Enabled:
+ - 'true'
+ X-Stripe-Routing-Context-Priority-Tier:
+ - api-testmode
+ X-Wc:
+ - 3c3
+ Strict-Transport-Security:
+ - max-age=63072000; includeSubDomains; preload
+ body:
+ encoding: UTF-8
+ string: |-
+ {
+ "object": "account_link",
+ "created": 1787840595,
+ "expires_at": 1787840895,
+ "url": "https://connect.stripe.com/setup/e/acct_1U94CyII65DRaZXS/Npo82VsRxANH"
+ }
+ recorded_at: Thu, 27 Aug 2026 14:23:15 GMT
+recorded_with: VCR 6.4.0
diff --git a/spree/providers/stripe/spec/vcr/connect_create_express_account_manual_payouts.yml b/spree/providers/stripe/spec/vcr/connect_create_express_account_manual_payouts.yml
new file mode 100644
index 0000000000..fb0dd813c8
--- /dev/null
+++ b/spree/providers/stripe/spec/vcr/connect_create_express_account_manual_payouts.yml
@@ -0,0 +1,574 @@
+---
+http_interactions:
+- request:
+ method: post
+ uri: https://api.stripe.com/v1/accounts
+ body:
+ encoding: UTF-8
+ string: country=US&business_profile[name]=Sparks+Audio&controller[fees][payer]=application&controller[losses][payments]=application&controller[stripe_dashboard][type]=express&capabilities[transfers][requested]=true&settings[payouts][schedule][interval]=manual&metadata[spree_seller_id]=1
+ headers:
+ User-Agent:
+ - Stripe/v1 RubyBindings/18.4.2 Spree Stripe/6.0.0.alpha (https://spreecommerce.org)
+ AIAgent/claude_code
+ Authorization:
+ - Bearer <STRIPE_SECRET_KEY>
+ X-Stripe-Client-Telemetry:
+ - '{"last_request_metrics":{"request_id":"req_NY9zqv9KgPhlNL","request_duration_ms":352}}'
+ Idempotency-Key:
+ - spree-seller-sel_UkLWZg9DAJ-1787840585
+ Stripe-Version:
+ - '2023-10-16'
+ X-Stripe-Client-User-Agent:
+ - "<FILTERED>"
+ Content-Type:
+ - application/x-www-form-urlencoded
+ Accept-Encoding:
+ - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+ Accept:
+ - "*/*"
+ response:
+ status:
+ code: 200
+ message: OK
+ headers:
+ Server:
+ - nginx
+ Date:
+ - Thu, 27 Aug 2026 14:23:08 GMT
+ Content-Type:
+ - application/json
+ Content-Length:
+ - '3562'
+ Connection:
+ - keep-alive
+ Access-Control-Allow-Credentials:
+ - 'true'
+ Access-Control-Allow-Methods:
+ - GET, HEAD, PUT, PATCH, POST, DELETE
+ Access-Control-Allow-Origin:
+ - "*"
+ Access-Control-Expose-Headers:
+ - Request-Id, Stripe-Manage-Version, Stripe-Should-Retry, X-Stripe-External-Auth-Required,
+ X-Stripe-Privileged-Session-Required
+ Access-Control-Max-Age:
+ - '300'
+ Cache-Control:
+ - no-cache, no-store
+ Content-Security-Policy:
+ - base-uri 'none'; default-src 'none'; form-action 'none'; frame-ancestors 'none';
+ img-src 'self'; script-src 'self' 'report-sample'; style-src 'self'; worker-src
+ 'none'; upgrade-insecure-requests; report-uri https://q.stripe.com/csp-violation?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ;
+ report-to csp
+ Idempotency-Key:
+ - spree-seller-sel_UkLWZg9DAJ-1787840585
+ Original-Request:
+ - req_MyAfIySmP0bK2d
+ Report-To:
+ - '{"group":"csp","max_age":8640,"endpoints":[{"url":"https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"}],"include_subdomains":true}'
+ Reporting-Endpoints:
+ - csp="https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"
+ Request-Id:
+ - req_MyAfIySmP0bK2d
+ Stripe-Notice:
+ - '2 notices for this request: (1) You are using an outdated API version (2023-10-16).
+ We recommend upgrading to the latest API version, 2026-07-29.dahlia. See https://docs.stripe.com/upgrades
+ (2) We recommend building your integration using Accounts v2. See https://docs.stripe.com/api/v2/core/accounts'
+ Stripe-Should-Retry:
+ - 'false'
+ Stripe-Version:
+ - '2023-10-16'
+ Vary:
+ - Origin
+ X-Stripe-Priority-Routing-Enabled:
+ - 'true'
+ X-Stripe-Routing-Context-Priority-Tier:
+ - api-testmode
+ X-Wc:
+ - 3c3
+ Strict-Transport-Security:
+ - max-age=63072000; includeSubDomains; preload
+ body:
+ encoding: UTF-8
+ string: |-
+ {
+ "id": "acct_1U94CrRDyk3UChj7",
+ "object": "account",
+ "business_profile": {
+ "annual_revenue": null,
+ "estimated_worker_count": null,
+ "mcc": null,
+ "minority_owned_business_designation": null,
+ "name": "Sparks Audio",
+ "product_description": null,
+ "specified_commercial_transactions_act_url": null,
+ "support_address": null,
+ "support_email": null,
+ "support_phone": null,
+ "support_url": null,
+ "url": null
+ },
+ "business_type": null,
+ "capabilities": {
+ "transfers": "inactive"
+ },
+ "charges_enabled": false,
+ "controller": {
+ "fees": {
+ "payer": "application"
+ },
+ "is_controller": true,
+ "losses": {
+ "payments": "application"
+ },
+ "requirement_collection": "stripe",
+ "stripe_dashboard": {
+ "type": "express"
+ },
+ "type": "application"
+ },
+ "country": "US",
+ "created": 1787840586,
+ "default_currency": "usd",
+ "details_submitted": false,
+ "email": null,
+ "external_accounts": {
+ "object": "list",
+ "data": [],
+ "has_more": false,
+ "total_count": 0,
+ "url": "/v1/accounts/acct_1U94CrRDyk3UChj7/external_accounts"
+ },
+ "future_requirements": {
+ "alternatives": [],
+ "current_deadline": null,
+ "currently_due": [],
+ "disabled_reason": null,
+ "errors": [],
+ "eventually_due": [],
+ "past_due": [],
+ "pending_verification": []
+ },
+ "login_links": {
+ "object": "list",
+ "data": [],
+ "has_more": false,
+ "total_count": 0,
+ "url": "/v1/accounts/acct_1U94CrRDyk3UChj7/login_links"
+ },
+ "metadata": {
+ "spree_seller_id": "1"
+ },
+ "payouts_enabled": false,
+ "requirements": {
+ "alternatives": [],
+ "current_deadline": null,
+ "currently_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "disabled_reason": "requirements.past_due",
+ "errors": [],
+ "eventually_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "past_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "pending_verification": []
+ },
+ "settings": {
+ "bacs_debit_payments": {
+ "display_name": null,
+ "service_user_number": null
+ },
+ "branding": {
+ "icon": null,
+ "logo": null,
+ "primary_color": null,
+ "secondary_color": null
+ },
+ "card_issuing": {
+ "tos_acceptance": {
+ "date": null,
+ "ip": null
+ }
+ },
+ "card_payments": {
+ "decline_on": {
+ "avs_failure": false,
+ "cvc_failure": false
+ },
+ "statement_descriptor_prefix": "SPARKS AUD",
+ "statement_descriptor_prefix_kana": null,
+ "statement_descriptor_prefix_kanji": null
+ },
+ "dashboard": {
+ "display_name": "Sparks Audio",
+ "timezone": "Etc/UTC"
+ },
+ "invoices": {
+ "default_account_tax_ids": null,
+ "hosted_payment_method_save": "offer"
+ },
+ "payments": {
+ "statement_descriptor": "SPARKS AUDIO",
+ "statement_descriptor_kana": null,
+ "statement_descriptor_kanji": null
+ },
+ "payouts": {
+ "debit_negative_balances": true,
+ "schedule": {
+ "delay_days": 2,
+ "interval": "manual"
+ },
+ "statement_descriptor": null
+ },
+ "sepa_debit_payments": {}
+ },
+ "tos_acceptance": {
+ "date": null,
+ "ip": null,
+ "user_agent": null
+ },
+ "type": "none"
+ }
+ recorded_at: Thu, 27 Aug 2026 14:23:08 GMT
+- request:
+ method: post
+ uri: https://api.stripe.com/v1/account_links
+ body:
+ encoding: UTF-8
+ string: account=acct_1U94CrRDyk3UChj7&refresh_url=https%3A%2F%2Fexample.test%2Fonboarding&return_url=https%3A%2F%2Fexample.test%2Fonboarding&type=account_onboarding
+ headers:
+ User-Agent:
+ - Stripe/v1 RubyBindings/18.4.2 Spree Stripe/6.0.0.alpha (https://spreecommerce.org)
+ AIAgent/claude_code
+ Authorization:
+ - Bearer <STRIPE_SECRET_KEY>
+ X-Stripe-Client-Telemetry:
+ - '{"last_request_metrics":{"request_id":"req_MyAfIySmP0bK2d","request_duration_ms":2325}}'
+ Idempotency-Key:
+ - '09ac51be-08ad-41b3-946c-f5f14e7c7e68'
+ Stripe-Version:
+ - '2023-10-16'
+ X-Stripe-Client-User-Agent:
+ - "<FILTERED>"
+ Content-Type:
+ - application/x-www-form-urlencoded
+ Accept-Encoding:
+ - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+ Accept:
+ - "*/*"
+ response:
+ status:
+ code: 200
+ message: OK
+ headers:
+ Server:
+ - nginx
+ Date:
+ - Thu, 27 Aug 2026 14:23:08 GMT
+ Content-Type:
+ - application/json
+ Content-Length:
+ - '165'
+ Connection:
+ - keep-alive
+ Access-Control-Allow-Credentials:
+ - 'true'
+ Access-Control-Allow-Methods:
+ - GET, HEAD, PUT, PATCH, POST, DELETE
+ Access-Control-Allow-Origin:
+ - "*"
+ Access-Control-Expose-Headers:
+ - Request-Id, Stripe-Manage-Version, Stripe-Should-Retry, X-Stripe-External-Auth-Required,
+ X-Stripe-Privileged-Session-Required
+ Access-Control-Max-Age:
+ - '300'
+ Cache-Control:
+ - no-cache, no-store
+ Content-Security-Policy:
+ - base-uri 'none'; default-src 'none'; form-action 'none'; frame-ancestors 'none';
+ img-src 'self'; script-src 'self' 'report-sample'; style-src 'self'; worker-src
+ 'none'; upgrade-insecure-requests; report-uri https://q.stripe.com/csp-violation?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ;
+ report-to csp
+ Idempotency-Key:
+ - '09ac51be-08ad-41b3-946c-f5f14e7c7e68'
+ Original-Request:
+ - req_t1Foj0PjlZQsGe
+ Report-To:
+ - '{"group":"csp","max_age":8640,"endpoints":[{"url":"https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"}],"include_subdomains":true}'
+ Reporting-Endpoints:
+ - csp="https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"
+ Request-Id:
+ - req_t1Foj0PjlZQsGe
+ Stripe-Notice:
+ - You are using an outdated API version (2023-10-16). We recommend upgrading
+ to the latest API version, 2026-07-29.dahlia. See https://docs.stripe.com/upgrades
+ Stripe-Should-Retry:
+ - 'false'
+ Stripe-Version:
+ - '2023-10-16'
+ Vary:
+ - Origin
+ X-Stripe-Priority-Routing-Enabled:
+ - 'true'
+ X-Stripe-Routing-Context-Priority-Tier:
+ - api-testmode
+ X-Wc:
+ - 3c3
+ Strict-Transport-Security:
+ - max-age=63072000; includeSubDomains; preload
+ body:
+ encoding: UTF-8
+ string: |-
+ {
+ "object": "account_link",
+ "created": 1787840588,
+ "expires_at": 1787840888,
+ "url": "https://connect.stripe.com/setup/e/acct_1U94CrRDyk3UChj7/oUtc0L9yrg5L"
+ }
+ recorded_at: Thu, 27 Aug 2026 14:23:08 GMT
+- request:
+ method: get
+ uri: https://api.stripe.com/v1/accounts/acct_1U94CrRDyk3UChj7
+ body:
+ encoding: US-ASCII
+ string: ''
+ headers:
+ User-Agent:
+ - Stripe/v1 RubyBindings/18.4.2 Spree Stripe/6.0.0.alpha (https://spreecommerce.org)
+ AIAgent/claude_code
+ Authorization:
+ - Bearer <STRIPE_SECRET_KEY>
+ X-Stripe-Client-Telemetry:
+ - '{"last_request_metrics":{"request_id":"req_t1Foj0PjlZQsGe","request_duration_ms":622}}'
+ Stripe-Version:
+ - '2023-10-16'
+ X-Stripe-Client-User-Agent:
+ - "<FILTERED>"
+ Accept-Encoding:
+ - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+ Accept:
+ - "*/*"
+ response:
+ status:
+ code: 200
+ message: OK
+ headers:
+ Server:
+ - nginx
+ Date:
+ - Thu, 27 Aug 2026 14:23:09 GMT
+ Content-Type:
+ - application/json
+ Content-Length:
+ - '3434'
+ Connection:
+ - keep-alive
+ Access-Control-Allow-Credentials:
+ - 'true'
+ Access-Control-Allow-Methods:
+ - GET, HEAD, PUT, PATCH, POST, DELETE
+ Access-Control-Allow-Origin:
+ - "*"
+ Access-Control-Expose-Headers:
+ - Request-Id, Stripe-Manage-Version, Stripe-Should-Retry, X-Stripe-External-Auth-Required,
+ X-Stripe-Privileged-Session-Required
+ Access-Control-Max-Age:
+ - '300'
+ Cache-Control:
+ - no-cache, no-store
+ Content-Security-Policy:
+ - base-uri 'none'; default-src 'none'; form-action 'none'; frame-ancestors 'none';
+ img-src 'self'; script-src 'self' 'report-sample'; style-src 'self'; worker-src
+ 'none'; upgrade-insecure-requests; report-uri https://q.stripe.com/csp-violation?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ;
+ report-to csp
+ Report-To:
+ - '{"group":"csp","max_age":8640,"endpoints":[{"url":"https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"}],"include_subdomains":true}'
+ Reporting-Endpoints:
+ - csp="https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"
+ Request-Id:
+ - req_bHqijFnLC0u6h4
+ Stripe-Account:
+ - acct_1U94CrRDyk3UChj7
+ Stripe-Notice:
+ - You are using an outdated API version (2023-10-16). We recommend upgrading
+ to the latest API version, 2026-07-29.dahlia. See https://docs.stripe.com/upgrades
+ Stripe-Version:
+ - '2023-10-16'
+ Vary:
+ - Origin
+ X-Stripe-Priority-Routing-Enabled:
+ - 'true'
+ X-Stripe-Routing-Context-Priority-Tier:
+ - api-testmode
+ X-Wc:
+ - 3c3
+ Strict-Transport-Security:
+ - max-age=63072000; includeSubDomains; preload
+ body:
+ encoding: UTF-8
+ string: |-
+ {
+ "id": "acct_1U94CrRDyk3UChj7",
+ "object": "account",
+ "business_profile": {
+ "annual_revenue": null,
+ "estimated_worker_count": null,
+ "mcc": null,
+ "minority_owned_business_designation": null,
+ "name": "Sparks Audio",
+ "support_address": null,
+ "support_email": null,
+ "support_phone": null,
+ "support_url": null,
+ "url": null
+ },
+ "business_type": null,
+ "capabilities": {
+ "transfers": "inactive"
+ },
+ "charges_enabled": false,
+ "controller": {
+ "fees": {
+ "payer": "application"
+ },
+ "is_controller": true,
+ "losses": {
+ "payments": "application"
+ },
+ "requirement_collection": "stripe",
+ "stripe_dashboard": {
+ "type": "express"
+ },
+ "type": "application"
+ },
+ "country": "US",
+ "created": 1787840586,
+ "default_currency": "usd",
+ "details_submitted": false,
+ "email": null,
+ "external_accounts": {
+ "object": "list",
+ "data": [],
+ "has_more": false,
+ "total_count": 0,
+ "url": "/v1/accounts/acct_1U94CrRDyk3UChj7/external_accounts"
+ },
+ "future_requirements": {
+ "alternatives": [],
+ "current_deadline": null,
+ "currently_due": [],
+ "disabled_reason": null,
+ "errors": [],
+ "eventually_due": [],
+ "past_due": [],
+ "pending_verification": []
+ },
+ "login_links": {
+ "object": "list",
+ "data": [],
+ "has_more": false,
+ "total_count": 0,
+ "url": "/v1/accounts/acct_1U94CrRDyk3UChj7/login_links"
+ },
+ "metadata": {
+ "spree_seller_id": "1"
+ },
+ "payouts_enabled": false,
+ "requirements": {
+ "alternatives": [],
+ "current_deadline": null,
+ "currently_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "disabled_reason": "requirements.past_due",
+ "errors": [],
+ "eventually_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "past_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "pending_verification": []
+ },
+ "settings": {
+ "bacs_debit_payments": {
+ "display_name": null,
+ "service_user_number": null
+ },
+ "branding": {
+ "icon": null,
+ "logo": null,
+ "primary_color": null,
+ "secondary_color": null
+ },
+ "card_issuing": {
+ "tos_acceptance": {
+ "date": null,
+ "ip": null
+ }
+ },
+ "card_payments": {
+ "decline_on": {
+ "avs_failure": false,
+ "cvc_failure": false
+ },
+ "statement_descriptor_prefix": "SPARKS AUD",
+ "statement_descriptor_prefix_kana": null,
+ "statement_descriptor_prefix_kanji": null
+ },
+ "dashboard": {
+ "display_name": "Sparks Audio",
+ "timezone": "Etc/UTC"
+ },
+ "invoices": {
+ "default_account_tax_ids": null,
+ "hosted_payment_method_save": "offer"
+ },
+ "payments": {
+ "statement_descriptor": "SPARKS AUDIO",
+ "statement_descriptor_kana": null,
+ "statement_descriptor_kanji": null
+ },
+ "payouts": {
+ "debit_negative_balances": true,
+ "schedule": {
+ "delay_days": 2,
+ "interval": "manual"
+ },
+ "statement_descriptor": null
+ },
+ "sepa_debit_payments": {}
+ },
+ "tos_acceptance": {
+ "date": null
+ },
+ "type": "none"
+ }
+ recorded_at: Thu, 27 Aug 2026 14:23:09 GMT
+recorded_with: VCR 6.4.0
diff --git a/spree/providers/stripe/spec/vcr/connect_create_express_account_shape.yml b/spree/providers/stripe/spec/vcr/connect_create_express_account_shape.yml
new file mode 100644
index 0000000000..f98005b8c2
--- /dev/null
+++ b/spree/providers/stripe/spec/vcr/connect_create_express_account_shape.yml
@@ -0,0 +1,574 @@
+---
+http_interactions:
+- request:
+ method: post
+ uri: https://api.stripe.com/v1/accounts
+ body:
+ encoding: UTF-8
+ string: country=US&business_profile[name]=Sparks+Audio&controller[fees][payer]=application&controller[losses][payments]=application&controller[stripe_dashboard][type]=express&capabilities[transfers][requested]=true&settings[payouts][schedule][interval]=manual&metadata[spree_seller_id]=1
+ headers:
+ User-Agent:
+ - Stripe/v1 RubyBindings/18.4.2 Spree Stripe/6.0.0.alpha (https://spreecommerce.org)
+ AIAgent/claude_code
+ Authorization:
+ - Bearer <STRIPE_SECRET_KEY>
+ X-Stripe-Client-Telemetry:
+ - '{"last_request_metrics":{"request_id":"req_bHqijFnLC0u6h4","request_duration_ms":520}}'
+ Idempotency-Key:
+ - spree-seller-sel_UkLWZg9DAJ-1787840589
+ Stripe-Version:
+ - '2023-10-16'
+ X-Stripe-Client-User-Agent:
+ - "<FILTERED>"
+ Content-Type:
+ - application/x-www-form-urlencoded
+ Accept-Encoding:
+ - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+ Accept:
+ - "*/*"
+ response:
+ status:
+ code: 200
+ message: OK
+ headers:
+ Server:
+ - nginx
+ Date:
+ - Thu, 27 Aug 2026 14:23:11 GMT
+ Content-Type:
+ - application/json
+ Content-Length:
+ - '3562'
+ Connection:
+ - keep-alive
+ Access-Control-Allow-Credentials:
+ - 'true'
+ Access-Control-Allow-Methods:
+ - GET, HEAD, PUT, PATCH, POST, DELETE
+ Access-Control-Allow-Origin:
+ - "*"
+ Access-Control-Expose-Headers:
+ - Request-Id, Stripe-Manage-Version, Stripe-Should-Retry, X-Stripe-External-Auth-Required,
+ X-Stripe-Privileged-Session-Required
+ Access-Control-Max-Age:
+ - '300'
+ Cache-Control:
+ - no-cache, no-store
+ Content-Security-Policy:
+ - base-uri 'none'; default-src 'none'; form-action 'none'; frame-ancestors 'none';
+ img-src 'self'; script-src 'self' 'report-sample'; style-src 'self'; worker-src
+ 'none'; upgrade-insecure-requests; report-uri https://q.stripe.com/csp-violation?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ;
+ report-to csp
+ Idempotency-Key:
+ - spree-seller-sel_UkLWZg9DAJ-1787840589
+ Original-Request:
+ - req_LbLAyuL2zXgvdz
+ Report-To:
+ - '{"group":"csp","max_age":8640,"endpoints":[{"url":"https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"}],"include_subdomains":true}'
+ Reporting-Endpoints:
+ - csp="https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"
+ Request-Id:
+ - req_LbLAyuL2zXgvdz
+ Stripe-Notice:
+ - '2 notices for this request: (1) You are using an outdated API version (2023-10-16).
+ We recommend upgrading to the latest API version, 2026-07-29.dahlia. See https://docs.stripe.com/upgrades
+ (2) We recommend building your integration using Accounts v2. See https://docs.stripe.com/api/v2/core/accounts'
+ Stripe-Should-Retry:
+ - 'false'
+ Stripe-Version:
+ - '2023-10-16'
+ Vary:
+ - Origin
+ X-Stripe-Priority-Routing-Enabled:
+ - 'true'
+ X-Stripe-Routing-Context-Priority-Tier:
+ - api-testmode
+ X-Wc:
+ - 3c3
+ Strict-Transport-Security:
+ - max-age=63072000; includeSubDomains; preload
+ body:
+ encoding: UTF-8
+ string: |-
+ {
+ "id": "acct_1U94CvIUGG1acHmx",
+ "object": "account",
+ "business_profile": {
+ "annual_revenue": null,
+ "estimated_worker_count": null,
+ "mcc": null,
+ "minority_owned_business_designation": null,
+ "name": "Sparks Audio",
+ "product_description": null,
+ "specified_commercial_transactions_act_url": null,
+ "support_address": null,
+ "support_email": null,
+ "support_phone": null,
+ "support_url": null,
+ "url": null
+ },
+ "business_type": null,
+ "capabilities": {
+ "transfers": "inactive"
+ },
+ "charges_enabled": false,
+ "controller": {
+ "fees": {
+ "payer": "application"
+ },
+ "is_controller": true,
+ "losses": {
+ "payments": "application"
+ },
+ "requirement_collection": "stripe",
+ "stripe_dashboard": {
+ "type": "express"
+ },
+ "type": "application"
+ },
+ "country": "US",
+ "created": 1787840590,
+ "default_currency": "usd",
+ "details_submitted": false,
+ "email": null,
+ "external_accounts": {
+ "object": "list",
+ "data": [],
+ "has_more": false,
+ "total_count": 0,
+ "url": "/v1/accounts/acct_1U94CvIUGG1acHmx/external_accounts"
+ },
+ "future_requirements": {
+ "alternatives": [],
+ "current_deadline": null,
+ "currently_due": [],
+ "disabled_reason": null,
+ "errors": [],
+ "eventually_due": [],
+ "past_due": [],
+ "pending_verification": []
+ },
+ "login_links": {
+ "object": "list",
+ "data": [],
+ "has_more": false,
+ "total_count": 0,
+ "url": "/v1/accounts/acct_1U94CvIUGG1acHmx/login_links"
+ },
+ "metadata": {
+ "spree_seller_id": "1"
+ },
+ "payouts_enabled": false,
+ "requirements": {
+ "alternatives": [],
+ "current_deadline": null,
+ "currently_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "disabled_reason": "requirements.past_due",
+ "errors": [],
+ "eventually_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "past_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "pending_verification": []
+ },
+ "settings": {
+ "bacs_debit_payments": {
+ "display_name": null,
+ "service_user_number": null
+ },
+ "branding": {
+ "icon": null,
+ "logo": null,
+ "primary_color": null,
+ "secondary_color": null
+ },
+ "card_issuing": {
+ "tos_acceptance": {
+ "date": null,
+ "ip": null
+ }
+ },
+ "card_payments": {
+ "decline_on": {
+ "avs_failure": false,
+ "cvc_failure": false
+ },
+ "statement_descriptor_prefix": "SPARKS AUD",
+ "statement_descriptor_prefix_kana": null,
+ "statement_descriptor_prefix_kanji": null
+ },
+ "dashboard": {
+ "display_name": "Sparks Audio",
+ "timezone": "Etc/UTC"
+ },
+ "invoices": {
+ "default_account_tax_ids": null,
+ "hosted_payment_method_save": "offer"
+ },
+ "payments": {
+ "statement_descriptor": "SPARKS AUDIO",
+ "statement_descriptor_kana": null,
+ "statement_descriptor_kanji": null
+ },
+ "payouts": {
+ "debit_negative_balances": true,
+ "schedule": {
+ "delay_days": 2,
+ "interval": "manual"
+ },
+ "statement_descriptor": null
+ },
+ "sepa_debit_payments": {}
+ },
+ "tos_acceptance": {
+ "date": null,
+ "ip": null,
+ "user_agent": null
+ },
+ "type": "none"
+ }
+ recorded_at: Thu, 27 Aug 2026 14:23:11 GMT
+- request:
+ method: post
+ uri: https://api.stripe.com/v1/account_links
+ body:
+ encoding: UTF-8
+ string: account=acct_1U94CvIUGG1acHmx&refresh_url=https%3A%2F%2Fexample.test%2Fonboarding&return_url=https%3A%2F%2Fexample.test%2Fonboarding&type=account_onboarding
+ headers:
+ User-Agent:
+ - Stripe/v1 RubyBindings/18.4.2 Spree Stripe/6.0.0.alpha (https://spreecommerce.org)
+ AIAgent/claude_code
+ Authorization:
+ - Bearer <STRIPE_SECRET_KEY>
+ X-Stripe-Client-Telemetry:
+ - '{"last_request_metrics":{"request_id":"req_LbLAyuL2zXgvdz","request_duration_ms":2342}}'
+ Idempotency-Key:
+ - 926c3303-e848-4cd6-9325-1f00636e9257
+ Stripe-Version:
+ - '2023-10-16'
+ X-Stripe-Client-User-Agent:
+ - "<FILTERED>"
+ Content-Type:
+ - application/x-www-form-urlencoded
+ Accept-Encoding:
+ - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+ Accept:
+ - "*/*"
+ response:
+ status:
+ code: 200
+ message: OK
+ headers:
+ Server:
+ - nginx
+ Date:
+ - Thu, 27 Aug 2026 14:23:11 GMT
+ Content-Type:
+ - application/json
+ Content-Length:
+ - '165'
+ Connection:
+ - keep-alive
+ Access-Control-Allow-Credentials:
+ - 'true'
+ Access-Control-Allow-Methods:
+ - GET, HEAD, PUT, PATCH, POST, DELETE
+ Access-Control-Allow-Origin:
+ - "*"
+ Access-Control-Expose-Headers:
+ - Request-Id, Stripe-Manage-Version, Stripe-Should-Retry, X-Stripe-External-Auth-Required,
+ X-Stripe-Privileged-Session-Required
+ Access-Control-Max-Age:
+ - '300'
+ Cache-Control:
+ - no-cache, no-store
+ Content-Security-Policy:
+ - base-uri 'none'; default-src 'none'; form-action 'none'; frame-ancestors 'none';
+ img-src 'self'; script-src 'self' 'report-sample'; style-src 'self'; worker-src
+ 'none'; upgrade-insecure-requests; report-uri https://q.stripe.com/csp-violation?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ;
+ report-to csp
+ Idempotency-Key:
+ - 926c3303-e848-4cd6-9325-1f00636e9257
+ Original-Request:
+ - req_P35uzDo45BnkMc
+ Report-To:
+ - '{"group":"csp","max_age":8640,"endpoints":[{"url":"https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"}],"include_subdomains":true}'
+ Reporting-Endpoints:
+ - csp="https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"
+ Request-Id:
+ - req_P35uzDo45BnkMc
+ Stripe-Notice:
+ - You are using an outdated API version (2023-10-16). We recommend upgrading
+ to the latest API version, 2026-07-29.dahlia. See https://docs.stripe.com/upgrades
+ Stripe-Should-Retry:
+ - 'false'
+ Stripe-Version:
+ - '2023-10-16'
+ Vary:
+ - Origin
+ X-Stripe-Priority-Routing-Enabled:
+ - 'true'
+ X-Stripe-Routing-Context-Priority-Tier:
+ - api-testmode
+ X-Wc:
+ - 3c3
+ Strict-Transport-Security:
+ - max-age=63072000; includeSubDomains; preload
+ body:
+ encoding: UTF-8
+ string: |-
+ {
+ "object": "account_link",
+ "created": 1787840591,
+ "expires_at": 1787840891,
+ "url": "https://connect.stripe.com/setup/e/acct_1U94CvIUGG1acHmx/udlTJyXQbTME"
+ }
+ recorded_at: Thu, 27 Aug 2026 14:23:11 GMT
+- request:
+ method: get
+ uri: https://api.stripe.com/v1/accounts/acct_1U94CvIUGG1acHmx
+ body:
+ encoding: US-ASCII
+ string: ''
+ headers:
+ User-Agent:
+ - Stripe/v1 RubyBindings/18.4.2 Spree Stripe/6.0.0.alpha (https://spreecommerce.org)
+ AIAgent/claude_code
+ Authorization:
+ - Bearer <STRIPE_SECRET_KEY>
+ X-Stripe-Client-Telemetry:
+ - '{"last_request_metrics":{"request_id":"req_P35uzDo45BnkMc","request_duration_ms":340}}'
+ Stripe-Version:
+ - '2023-10-16'
+ X-Stripe-Client-User-Agent:
+ - "<FILTERED>"
+ Accept-Encoding:
+ - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+ Accept:
+ - "*/*"
+ response:
+ status:
+ code: 200
+ message: OK
+ headers:
+ Server:
+ - nginx
+ Date:
+ - Thu, 27 Aug 2026 14:23:12 GMT
+ Content-Type:
+ - application/json
+ Content-Length:
+ - '3434'
+ Connection:
+ - keep-alive
+ Access-Control-Allow-Credentials:
+ - 'true'
+ Access-Control-Allow-Methods:
+ - GET, HEAD, PUT, PATCH, POST, DELETE
+ Access-Control-Allow-Origin:
+ - "*"
+ Access-Control-Expose-Headers:
+ - Request-Id, Stripe-Manage-Version, Stripe-Should-Retry, X-Stripe-External-Auth-Required,
+ X-Stripe-Privileged-Session-Required
+ Access-Control-Max-Age:
+ - '300'
+ Cache-Control:
+ - no-cache, no-store
+ Content-Security-Policy:
+ - base-uri 'none'; default-src 'none'; form-action 'none'; frame-ancestors 'none';
+ img-src 'self'; script-src 'self' 'report-sample'; style-src 'self'; worker-src
+ 'none'; upgrade-insecure-requests; report-uri https://q.stripe.com/csp-violation?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ;
+ report-to csp
+ Report-To:
+ - '{"group":"csp","max_age":8640,"endpoints":[{"url":"https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"}],"include_subdomains":true}'
+ Reporting-Endpoints:
+ - csp="https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"
+ Request-Id:
+ - req_7H4neBTaIIVpom
+ Stripe-Account:
+ - acct_1U94CvIUGG1acHmx
+ Stripe-Notice:
+ - You are using an outdated API version (2023-10-16). We recommend upgrading
+ to the latest API version, 2026-07-29.dahlia. See https://docs.stripe.com/upgrades
+ Stripe-Version:
+ - '2023-10-16'
+ Vary:
+ - Origin
+ X-Stripe-Priority-Routing-Enabled:
+ - 'true'
+ X-Stripe-Routing-Context-Priority-Tier:
+ - api-testmode
+ X-Wc:
+ - 3c3
+ Strict-Transport-Security:
+ - max-age=63072000; includeSubDomains; preload
+ body:
+ encoding: UTF-8
+ string: |-
+ {
+ "id": "acct_1U94CvIUGG1acHmx",
+ "object": "account",
+ "business_profile": {
+ "annual_revenue": null,
+ "estimated_worker_count": null,
+ "mcc": null,
+ "minority_owned_business_designation": null,
+ "name": "Sparks Audio",
+ "support_address": null,
+ "support_email": null,
+ "support_phone": null,
+ "support_url": null,
+ "url": null
+ },
+ "business_type": null,
+ "capabilities": {
+ "transfers": "inactive"
+ },
+ "charges_enabled": false,
+ "controller": {
+ "fees": {
+ "payer": "application"
+ },
+ "is_controller": true,
+ "losses": {
+ "payments": "application"
+ },
+ "requirement_collection": "stripe",
+ "stripe_dashboard": {
+ "type": "express"
+ },
+ "type": "application"
+ },
+ "country": "US",
+ "created": 1787840590,
+ "default_currency": "usd",
+ "details_submitted": false,
+ "email": null,
+ "external_accounts": {
+ "object": "list",
+ "data": [],
+ "has_more": false,
+ "total_count": 0,
+ "url": "/v1/accounts/acct_1U94CvIUGG1acHmx/external_accounts"
+ },
+ "future_requirements": {
+ "alternatives": [],
+ "current_deadline": null,
+ "currently_due": [],
+ "disabled_reason": null,
+ "errors": [],
+ "eventually_due": [],
+ "past_due": [],
+ "pending_verification": []
+ },
+ "login_links": {
+ "object": "list",
+ "data": [],
+ "has_more": false,
+ "total_count": 0,
+ "url": "/v1/accounts/acct_1U94CvIUGG1acHmx/login_links"
+ },
+ "metadata": {
+ "spree_seller_id": "1"
+ },
+ "payouts_enabled": false,
+ "requirements": {
+ "alternatives": [],
+ "current_deadline": null,
+ "currently_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "disabled_reason": "requirements.past_due",
+ "errors": [],
+ "eventually_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "past_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "pending_verification": []
+ },
+ "settings": {
+ "bacs_debit_payments": {
+ "display_name": null,
+ "service_user_number": null
+ },
+ "branding": {
+ "icon": null,
+ "logo": null,
+ "primary_color": null,
+ "secondary_color": null
+ },
+ "card_issuing": {
+ "tos_acceptance": {
+ "date": null,
+ "ip": null
+ }
+ },
+ "card_payments": {
+ "decline_on": {
+ "avs_failure": false,
+ "cvc_failure": false
+ },
+ "statement_descriptor_prefix": "SPARKS AUD",
+ "statement_descriptor_prefix_kana": null,
+ "statement_descriptor_prefix_kanji": null
+ },
+ "dashboard": {
+ "display_name": "Sparks Audio",
+ "timezone": "Etc/UTC"
+ },
+ "invoices": {
+ "default_account_tax_ids": null,
+ "hosted_payment_method_save": "offer"
+ },
+ "payments": {
+ "statement_descriptor": "SPARKS AUDIO",
+ "statement_descriptor_kana": null,
+ "statement_descriptor_kanji": null
+ },
+ "payouts": {
+ "debit_negative_balances": true,
+ "schedule": {
+ "delay_days": 2,
+ "interval": "manual"
+ },
+ "statement_descriptor": null
+ },
+ "sepa_debit_payments": {}
+ },
+ "tos_acceptance": {
+ "date": null
+ },
+ "type": "none"
+ }
+ recorded_at: Thu, 27 Aug 2026 14:23:12 GMT
+recorded_with: VCR 6.4.0
diff --git a/spree/providers/stripe/spec/vcr/connect_relink_existing_account.yml b/spree/providers/stripe/spec/vcr/connect_relink_existing_account.yml
new file mode 100644
index 0000000000..b3fb627e8e
--- /dev/null
+++ b/spree/providers/stripe/spec/vcr/connect_relink_existing_account.yml
@@ -0,0 +1,437 @@
+---
+http_interactions:
+- request:
+ method: post
+ uri: https://api.stripe.com/v1/accounts
+ body:
+ encoding: UTF-8
+ string: country=US&business_profile[name]=Sparks+Audio&controller[fees][payer]=application&controller[losses][payments]=application&controller[stripe_dashboard][type]=express&capabilities[transfers][requested]=true&settings[payouts][schedule][interval]=manual&metadata[spree_seller_id]=1
+ headers:
+ User-Agent:
+ - Stripe/v1 RubyBindings/18.4.2 Spree Stripe/6.0.0.alpha (https://spreecommerce.org)
+ AIAgent/claude_code
+ Authorization:
+ - Bearer <STRIPE_SECRET_KEY>
+ Idempotency-Key:
+ - spree-seller-sel_UkLWZg9DAJ-1787840582
+ Stripe-Version:
+ - '2023-10-16'
+ X-Stripe-Client-User-Agent:
+ - "<FILTERED>"
+ Content-Type:
+ - application/x-www-form-urlencoded
+ Accept-Encoding:
+ - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+ Accept:
+ - "*/*"
+ response:
+ status:
+ code: 200
+ message: OK
+ headers:
+ Server:
+ - nginx
+ Date:
+ - Thu, 27 Aug 2026 14:23:04 GMT
+ Content-Type:
+ - application/json
+ Content-Length:
+ - '3562'
+ Connection:
+ - keep-alive
+ Access-Control-Allow-Credentials:
+ - 'true'
+ Access-Control-Allow-Methods:
+ - GET, HEAD, PUT, PATCH, POST, DELETE
+ Access-Control-Allow-Origin:
+ - "*"
+ Access-Control-Expose-Headers:
+ - Request-Id, Stripe-Manage-Version, Stripe-Should-Retry, X-Stripe-External-Auth-Required,
+ X-Stripe-Privileged-Session-Required
+ Access-Control-Max-Age:
+ - '300'
+ Cache-Control:
+ - no-cache, no-store
+ Content-Security-Policy:
+ - base-uri 'none'; default-src 'none'; form-action 'none'; frame-ancestors 'none';
+ img-src 'self'; script-src 'self' 'report-sample'; style-src 'self'; worker-src
+ 'none'; upgrade-insecure-requests; report-uri https://q.stripe.com/csp-violation?q=0OHf2PhACypjnVQTb-vlZf0g-IS6QN-RuP3BBl-HXquz1ogFB5-lWpvYNW7dPLgIZ1cjgBQN51dQ4qWj;
+ report-to csp
+ Idempotency-Key:
+ - spree-seller-sel_UkLWZg9DAJ-1787840582
+ Original-Request:
+ - req_eR0M10YFJFRpRn
+ Report-To:
+ - '{"group":"csp","max_age":8640,"endpoints":[{"url":"https://q.stripe.com/csp-report-v2?q=0OHf2PhACypjnVQTb-vlZf0g-IS6QN-RuP3BBl-HXquz1ogFB5-lWpvYNW7dPLgIZ1cjgBQN51dQ4qWj&t=1"}],"include_subdomains":true}'
+ Reporting-Endpoints:
+ - csp="https://q.stripe.com/csp-report-v2?q=0OHf2PhACypjnVQTb-vlZf0g-IS6QN-RuP3BBl-HXquz1ogFB5-lWpvYNW7dPLgIZ1cjgBQN51dQ4qWj&t=1"
+ Request-Id:
+ - req_eR0M10YFJFRpRn
+ Stripe-Notice:
+ - '2 notices for this request: (1) You are using an outdated API version (2023-10-16).
+ We recommend upgrading to the latest API version, 2026-07-29.dahlia. See https://docs.stripe.com/upgrades
+ (2) We recommend building your integration using Accounts v2. See https://docs.stripe.com/api/v2/core/accounts'
+ Stripe-Should-Retry:
+ - 'false'
+ Stripe-Version:
+ - '2023-10-16'
+ Vary:
+ - Origin
+ X-Stripe-Priority-Routing-Enabled:
+ - 'true'
+ X-Stripe-Routing-Context-Priority-Tier:
+ - api-testmode
+ X-Wc:
+ - 3c3
+ Strict-Transport-Security:
+ - max-age=63072000; includeSubDomains; preload
+ body:
+ encoding: UTF-8
+ string: |-
+ {
+ "id": "acct_1U94CoEfikSLUyjD",
+ "object": "account",
+ "business_profile": {
+ "annual_revenue": null,
+ "estimated_worker_count": null,
+ "mcc": null,
+ "minority_owned_business_designation": null,
+ "name": "Sparks Audio",
+ "product_description": null,
+ "specified_commercial_transactions_act_url": null,
+ "support_address": null,
+ "support_email": null,
+ "support_phone": null,
+ "support_url": null,
+ "url": null
+ },
+ "business_type": null,
+ "capabilities": {
+ "transfers": "inactive"
+ },
+ "charges_enabled": false,
+ "controller": {
+ "fees": {
+ "payer": "application"
+ },
+ "is_controller": true,
+ "losses": {
+ "payments": "application"
+ },
+ "requirement_collection": "stripe",
+ "stripe_dashboard": {
+ "type": "express"
+ },
+ "type": "application"
+ },
+ "country": "US",
+ "created": 1787840583,
+ "default_currency": "usd",
+ "details_submitted": false,
+ "email": null,
+ "external_accounts": {
+ "object": "list",
+ "data": [],
+ "has_more": false,
+ "total_count": 0,
+ "url": "/v1/accounts/acct_1U94CoEfikSLUyjD/external_accounts"
+ },
+ "future_requirements": {
+ "alternatives": [],
+ "current_deadline": null,
+ "currently_due": [],
+ "disabled_reason": null,
+ "errors": [],
+ "eventually_due": [],
+ "past_due": [],
+ "pending_verification": []
+ },
+ "login_links": {
+ "object": "list",
+ "data": [],
+ "has_more": false,
+ "total_count": 0,
+ "url": "/v1/accounts/acct_1U94CoEfikSLUyjD/login_links"
+ },
+ "metadata": {
+ "spree_seller_id": "1"
+ },
+ "payouts_enabled": false,
+ "requirements": {
+ "alternatives": [],
+ "current_deadline": null,
+ "currently_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "disabled_reason": "requirements.past_due",
+ "errors": [],
+ "eventually_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "past_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "pending_verification": []
+ },
+ "settings": {
+ "bacs_debit_payments": {
+ "display_name": null,
+ "service_user_number": null
+ },
+ "branding": {
+ "icon": null,
+ "logo": null,
+ "primary_color": null,
+ "secondary_color": null
+ },
+ "card_issuing": {
+ "tos_acceptance": {
+ "date": null,
+ "ip": null
+ }
+ },
+ "card_payments": {
+ "decline_on": {
+ "avs_failure": false,
+ "cvc_failure": false
+ },
+ "statement_descriptor_prefix": "SPARKS AUD",
+ "statement_descriptor_prefix_kana": null,
+ "statement_descriptor_prefix_kanji": null
+ },
+ "dashboard": {
+ "display_name": "Sparks Audio",
+ "timezone": "Etc/UTC"
+ },
+ "invoices": {
+ "default_account_tax_ids": null,
+ "hosted_payment_method_save": "offer"
+ },
+ "payments": {
+ "statement_descriptor": "SPARKS AUDIO",
+ "statement_descriptor_kana": null,
+ "statement_descriptor_kanji": null
+ },
+ "payouts": {
+ "debit_negative_balances": true,
+ "schedule": {
+ "delay_days": 2,
+ "interval": "manual"
+ },
+ "statement_descriptor": null
+ },
+ "sepa_debit_payments": {}
+ },
+ "tos_acceptance": {
+ "date": null,
+ "ip": null,
+ "user_agent": null
+ },
+ "type": "none"
+ }
+ recorded_at: Thu, 27 Aug 2026 14:23:04 GMT
+- request:
+ method: post
+ uri: https://api.stripe.com/v1/account_links
+ body:
+ encoding: UTF-8
+ string: account=acct_1U94CoEfikSLUyjD&refresh_url=https%3A%2F%2Fexample.test%2Fonboarding&return_url=https%3A%2F%2Fexample.test%2Fonboarding&type=account_onboarding
+ headers:
+ User-Agent:
+ - Stripe/v1 RubyBindings/18.4.2 Spree Stripe/6.0.0.alpha (https://spreecommerce.org)
+ AIAgent/claude_code
+ Authorization:
+ - Bearer <STRIPE_SECRET_KEY>
+ X-Stripe-Client-Telemetry:
+ - '{"last_request_metrics":{"request_id":"req_eR0M10YFJFRpRn","request_duration_ms":2457}}'
+ Idempotency-Key:
+ - d0fa24b4-029e-4a9d-b3f6-5efd6278b9aa
+ Stripe-Version:
+ - '2023-10-16'
+ X-Stripe-Client-User-Agent:
+ - "<FILTERED>"
+ Content-Type:
+ - application/x-www-form-urlencoded
+ Accept-Encoding:
+ - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+ Accept:
+ - "*/*"
+ response:
+ status:
+ code: 200
+ message: OK
+ headers:
+ Server:
+ - nginx
+ Date:
+ - Thu, 27 Aug 2026 14:23:05 GMT
+ Content-Type:
+ - application/json
+ Content-Length:
+ - '165'
+ Connection:
+ - keep-alive
+ Access-Control-Allow-Credentials:
+ - 'true'
+ Access-Control-Allow-Methods:
+ - GET, HEAD, PUT, PATCH, POST, DELETE
+ Access-Control-Allow-Origin:
+ - "*"
+ Access-Control-Expose-Headers:
+ - Request-Id, Stripe-Manage-Version, Stripe-Should-Retry, X-Stripe-External-Auth-Required,
+ X-Stripe-Privileged-Session-Required
+ Access-Control-Max-Age:
+ - '300'
+ Cache-Control:
+ - no-cache, no-store
+ Content-Security-Policy:
+ - base-uri 'none'; default-src 'none'; form-action 'none'; frame-ancestors 'none';
+ img-src 'self'; script-src 'self' 'report-sample'; style-src 'self'; worker-src
+ 'none'; upgrade-insecure-requests; report-uri https://q.stripe.com/csp-violation?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ;
+ report-to csp
+ Idempotency-Key:
+ - d0fa24b4-029e-4a9d-b3f6-5efd6278b9aa
+ Original-Request:
+ - req_evHdcT6k2A8NNw
+ Report-To:
+ - '{"group":"csp","max_age":8640,"endpoints":[{"url":"https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"}],"include_subdomains":true}'
+ Reporting-Endpoints:
+ - csp="https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"
+ Request-Id:
+ - req_evHdcT6k2A8NNw
+ Stripe-Notice:
+ - You are using an outdated API version (2023-10-16). We recommend upgrading
+ to the latest API version, 2026-07-29.dahlia. See https://docs.stripe.com/upgrades
+ Stripe-Should-Retry:
+ - 'false'
+ Stripe-Version:
+ - '2023-10-16'
+ Vary:
+ - Origin
+ X-Stripe-Priority-Routing-Enabled:
+ - 'true'
+ X-Stripe-Routing-Context-Priority-Tier:
+ - api-testmode
+ X-Wc:
+ - 3c3
+ Strict-Transport-Security:
+ - max-age=63072000; includeSubDomains; preload
+ body:
+ encoding: UTF-8
+ string: |-
+ {
+ "object": "account_link",
+ "created": 1787840585,
+ "expires_at": 1787840885,
+ "url": "https://connect.stripe.com/setup/e/acct_1U94CoEfikSLUyjD/UKP6NsKQ2lGb"
+ }
+ recorded_at: Thu, 27 Aug 2026 14:23:05 GMT
+- request:
+ method: post
+ uri: https://api.stripe.com/v1/account_links
+ body:
+ encoding: UTF-8
+ string: account=acct_1U94CoEfikSLUyjD&refresh_url=https%3A%2F%2Fexample.test%2Fonboarding&return_url=https%3A%2F%2Fexample.test%2Fonboarding&type=account_onboarding
+ headers:
+ User-Agent:
+ - Stripe/v1 RubyBindings/18.4.2 Spree Stripe/6.0.0.alpha (https://spreecommerce.org)
+ AIAgent/claude_code
+ Authorization:
+ - Bearer <STRIPE_SECRET_KEY>
+ X-Stripe-Client-Telemetry:
+ - '{"last_request_metrics":{"request_id":"req_evHdcT6k2A8NNw","request_duration_ms":576}}'
+ Idempotency-Key:
+ - 328715ac-cb8d-4b83-bb59-3809a9d214ba
+ Stripe-Version:
+ - '2023-10-16'
+ X-Stripe-Client-User-Agent:
+ - "<FILTERED>"
+ Content-Type:
+ - application/x-www-form-urlencoded
+ Accept-Encoding:
+ - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+ Accept:
+ - "*/*"
+ response:
+ status:
+ code: 200
+ message: OK
+ headers:
+ Server:
+ - nginx
+ Date:
+ - Thu, 27 Aug 2026 14:23:05 GMT
+ Content-Type:
+ - application/json
+ Content-Length:
+ - '165'
+ Connection:
+ - keep-alive
+ Access-Control-Allow-Credentials:
+ - 'true'
+ Access-Control-Allow-Methods:
+ - GET, HEAD, PUT, PATCH, POST, DELETE
+ Access-Control-Allow-Origin:
+ - "*"
+ Access-Control-Expose-Headers:
+ - Request-Id, Stripe-Manage-Version, Stripe-Should-Retry, X-Stripe-External-Auth-Required,
+ X-Stripe-Privileged-Session-Required
+ Access-Control-Max-Age:
+ - '300'
+ Cache-Control:
+ - no-cache, no-store
+ Content-Security-Policy:
+ - base-uri 'none'; default-src 'none'; form-action 'none'; frame-ancestors 'none';
+ img-src 'self'; script-src 'self' 'report-sample'; style-src 'self'; worker-src
+ 'none'; upgrade-insecure-requests; report-uri https://q.stripe.com/csp-violation?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ;
+ report-to csp
+ Idempotency-Key:
+ - 328715ac-cb8d-4b83-bb59-3809a9d214ba
+ Original-Request:
+ - req_NY9zqv9KgPhlNL
+ Report-To:
+ - '{"group":"csp","max_age":8640,"endpoints":[{"url":"https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"}],"include_subdomains":true}'
+ Reporting-Endpoints:
+ - csp="https://q.stripe.com/csp-report-v2?q=pHWZVt400jlEdZSQtUVFMNvx3X0l2HJDJVYLmCz89OhzTugKHXSGn6-bod2xIVZPTL1dDjaY-5lMA0XJ&t=1"
+ Request-Id:
+ - req_NY9zqv9KgPhlNL
+ Stripe-Notice:
+ - You are using an outdated API version (2023-10-16). We recommend upgrading
+ to the latest API version, 2026-07-29.dahlia. See https://docs.stripe.com/upgrades
+ Stripe-Should-Retry:
+ - 'false'
+ Stripe-Version:
+ - '2023-10-16'
+ Vary:
+ - Origin
+ X-Stripe-Priority-Routing-Enabled:
+ - 'true'
+ X-Stripe-Routing-Context-Priority-Tier:
+ - api-testmode
+ X-Wc:
+ - 3c3
+ Strict-Transport-Security:
+ - max-age=63072000; includeSubDomains; preload
+ body:
+ encoding: UTF-8
+ string: |-
+ {
+ "object": "account_link",
+ "created": 1787840585,
+ "expires_at": 1787840885,
+ "url": "https://connect.stripe.com/setup/e/acct_1U94CoEfikSLUyjD/yPhBlUflCJD6"
+ }
+ recorded_at: Thu, 27 Aug 2026 14:23:05 GMT
+recorded_with: VCR 6.4.0
diff --git a/spree/providers/stripe/spec/vcr/seller_payout_account_link.yml b/spree/providers/stripe/spec/vcr/seller_payout_account_link.yml
new file mode 100644
index 0000000000..2653ed45b8
--- /dev/null
+++ b/spree/providers/stripe/spec/vcr/seller_payout_account_link.yml
@@ -0,0 +1,341 @@
+---
+http_interactions:
+- request:
+ method: post
+ uri: https://api.stripe.com/v1/accounts
+ body:
+ encoding: UTF-8
+ string: country=US&business_profile[name]=Sparks+Audio&controller[fees][payer]=application&controller[losses][payments]=application&controller[stripe_dashboard][type]=express&capabilities[transfers][requested]=true&settings[payouts][schedule][interval]=manual&metadata[spree_seller_id]=1
+ headers:
+ User-Agent:
+ - Stripe/v1 RubyBindings/18.4.2 Spree Stripe/6.0.0.alpha (https://spreecommerce.org)
+ AIAgent/claude_code
+ Authorization:
+ - Bearer <STRIPE_SECRET_KEY>
+ Idempotency-Key:
+ - spree-seller-sel_UkLWZg9DAJ-1787840732
+ Stripe-Version:
+ - '2023-10-16'
+ X-Stripe-Client-User-Agent:
+ - "<FILTERED>"
+ Content-Type:
+ - application/x-www-form-urlencoded
+ Accept-Encoding:
+ - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+ Accept:
+ - "*/*"
+ response:
+ status:
+ code: 200
+ message: OK
+ headers:
+ Server:
+ - nginx
+ Date:
+ - Thu, 27 Aug 2026 14:25:35 GMT
+ Content-Type:
+ - application/json
+ Content-Length:
+ - '3562'
+ Connection:
+ - keep-alive
+ Access-Control-Allow-Credentials:
+ - 'true'
+ Access-Control-Allow-Methods:
+ - GET, HEAD, PUT, PATCH, POST, DELETE
+ Access-Control-Allow-Origin:
+ - "*"
+ Access-Control-Expose-Headers:
+ - Request-Id, Stripe-Manage-Version, Stripe-Should-Retry, X-Stripe-External-Auth-Required,
+ X-Stripe-Privileged-Session-Required
+ Access-Control-Max-Age:
+ - '300'
+ Cache-Control:
+ - no-cache, no-store
+ Content-Security-Policy:
+ - base-uri 'none'; default-src 'none'; form-action 'none'; frame-ancestors 'none';
+ img-src 'self'; script-src 'self' 'report-sample'; style-src 'self'; worker-src
+ 'none'; upgrade-insecure-requests; report-uri https://q.stripe.com/csp-violation?q=tjlhL_o8x62j4l0_yYPsmLsEK3I7QHaNn1VA_L3z69iqH1GoTvdSSDS_A7dM5xrA05Uy-bihVAj8EFqj;
+ report-to csp
+ Idempotency-Key:
+ - spree-seller-sel_UkLWZg9DAJ-1787840732
+ Original-Request:
+ - req_m6LCOTPGu0i3Ec
+ Report-To:
+ - '{"group":"csp","max_age":8640,"endpoints":[{"url":"https://q.stripe.com/csp-report-v2?q=tjlhL_o8x62j4l0_yYPsmLsEK3I7QHaNn1VA_L3z69iqH1GoTvdSSDS_A7dM5xrA05Uy-bihVAj8EFqj&t=1"}],"include_subdomains":true}'
+ Reporting-Endpoints:
+ - csp="https://q.stripe.com/csp-report-v2?q=tjlhL_o8x62j4l0_yYPsmLsEK3I7QHaNn1VA_L3z69iqH1GoTvdSSDS_A7dM5xrA05Uy-bihVAj8EFqj&t=1"
+ Request-Id:
+ - req_m6LCOTPGu0i3Ec
+ Stripe-Notice:
+ - '2 notices for this request: (1) You are using an outdated API version (2023-10-16).
+ We recommend upgrading to the latest API version, 2026-07-29.dahlia. See https://docs.stripe.com/upgrades
+ (2) We recommend building your integration using Accounts v2. See https://docs.stripe.com/api/v2/core/accounts'
+ Stripe-Should-Retry:
+ - 'false'
+ Stripe-Version:
+ - '2023-10-16'
+ Vary:
+ - Origin
+ X-Stripe-Priority-Routing-Enabled:
+ - 'true'
+ X-Stripe-Routing-Context-Priority-Tier:
+ - api-testmode
+ X-Wc:
+ - 3c3
+ Strict-Transport-Security:
+ - max-age=63072000; includeSubDomains; preload
+ body:
+ encoding: UTF-8
+ string: |-
+ {
+ "id": "acct_1U94FFIJXFd0G4T5",
+ "object": "account",
+ "business_profile": {
+ "annual_revenue": null,
+ "estimated_worker_count": null,
+ "mcc": null,
+ "minority_owned_business_designation": null,
+ "name": "Sparks Audio",
+ "product_description": null,
+ "specified_commercial_transactions_act_url": null,
+ "support_address": null,
+ "support_email": null,
+ "support_phone": null,
+ "support_url": null,
+ "url": null
+ },
+ "business_type": null,
+ "capabilities": {
+ "transfers": "inactive"
+ },
+ "charges_enabled": false,
+ "controller": {
+ "fees": {
+ "payer": "application"
+ },
+ "is_controller": true,
+ "losses": {
+ "payments": "application"
+ },
+ "requirement_collection": "stripe",
+ "stripe_dashboard": {
+ "type": "express"
+ },
+ "type": "application"
+ },
+ "country": "US",
+ "created": 1787840734,
+ "default_currency": "usd",
+ "details_submitted": false,
+ "email": null,
+ "external_accounts": {
+ "object": "list",
+ "data": [],
+ "has_more": false,
+ "total_count": 0,
+ "url": "/v1/accounts/acct_1U94FFIJXFd0G4T5/external_accounts"
+ },
+ "future_requirements": {
+ "alternatives": [],
+ "current_deadline": null,
+ "currently_due": [],
+ "disabled_reason": null,
+ "errors": [],
+ "eventually_due": [],
+ "past_due": [],
+ "pending_verification": []
+ },
+ "login_links": {
+ "object": "list",
+ "data": [],
+ "has_more": false,
+ "total_count": 0,
+ "url": "/v1/accounts/acct_1U94FFIJXFd0G4T5/login_links"
+ },
+ "metadata": {
+ "spree_seller_id": "1"
+ },
+ "payouts_enabled": false,
+ "requirements": {
+ "alternatives": [],
+ "current_deadline": null,
+ "currently_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "disabled_reason": "requirements.past_due",
+ "errors": [],
+ "eventually_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "past_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "pending_verification": []
+ },
+ "settings": {
+ "bacs_debit_payments": {
+ "display_name": null,
+ "service_user_number": null
+ },
+ "branding": {
+ "icon": null,
+ "logo": null,
+ "primary_color": null,
+ "secondary_color": null
+ },
+ "card_issuing": {
+ "tos_acceptance": {
+ "date": null,
+ "ip": null
+ }
+ },
+ "card_payments": {
+ "decline_on": {
+ "avs_failure": false,
+ "cvc_failure": false
+ },
+ "statement_descriptor_prefix": "SPARKS AUD",
+ "statement_descriptor_prefix_kana": null,
+ "statement_descriptor_prefix_kanji": null
+ },
+ "dashboard": {
+ "display_name": "Sparks Audio",
+ "timezone": "Etc/UTC"
+ },
+ "invoices": {
+ "default_account_tax_ids": null,
+ "hosted_payment_method_save": "offer"
+ },
+ "payments": {
+ "statement_descriptor": "SPARKS AUDIO",
+ "statement_descriptor_kana": null,
+ "statement_descriptor_kanji": null
+ },
+ "payouts": {
+ "debit_negative_balances": true,
+ "schedule": {
+ "delay_days": 2,
+ "interval": "manual"
+ },
+ "statement_descriptor": null
+ },
+ "sepa_debit_payments": {}
+ },
+ "tos_acceptance": {
+ "date": null,
+ "ip": null,
+ "user_agent": null
+ },
+ "type": "none"
+ }
+ recorded_at: Thu, 27 Aug 2026 14:25:35 GMT
+- request:
+ method: post
+ uri: https://api.stripe.com/v1/account_links
+ body:
+ encoding: UTF-8
+ string: account=acct_1U94FFIJXFd0G4T5&refresh_url=https%3A%2F%2Fexample.test%2Fonboarding&return_url=https%3A%2F%2Fexample.test%2Fonboarding&type=account_onboarding
+ headers:
+ User-Agent:
+ - Stripe/v1 RubyBindings/18.4.2 Spree Stripe/6.0.0.alpha (https://spreecommerce.org)
+ AIAgent/claude_code
+ Authorization:
+ - Bearer <STRIPE_SECRET_KEY>
+ X-Stripe-Client-Telemetry:
+ - '{"last_request_metrics":{"request_id":"req_m6LCOTPGu0i3Ec","request_duration_ms":2804}}'
+ Idempotency-Key:
+ - 621d94b1-f1b6-4c1a-930e-891e419082c0
+ Stripe-Version:
+ - '2023-10-16'
+ X-Stripe-Client-User-Agent:
+ - "<FILTERED>"
+ Content-Type:
+ - application/x-www-form-urlencoded
+ Accept-Encoding:
+ - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+ Accept:
+ - "*/*"
+ response:
+ status:
+ code: 200
+ message: OK
+ headers:
+ Server:
+ - nginx
+ Date:
+ - Thu, 27 Aug 2026 14:25:36 GMT
+ Content-Type:
+ - application/json
+ Content-Length:
+ - '165'
+ Connection:
+ - keep-alive
+ Access-Control-Allow-Credentials:
+ - 'true'
+ Access-Control-Allow-Methods:
+ - GET, HEAD, PUT, PATCH, POST, DELETE
+ Access-Control-Allow-Origin:
+ - "*"
+ Access-Control-Expose-Headers:
+ - Request-Id, Stripe-Manage-Version, Stripe-Should-Retry, X-Stripe-External-Auth-Required,
+ X-Stripe-Privileged-Session-Required
+ Access-Control-Max-Age:
+ - '300'
+ Cache-Control:
+ - no-cache, no-store
+ Content-Security-Policy:
+ - base-uri 'none'; default-src 'none'; form-action 'none'; frame-ancestors 'none';
+ img-src 'self'; script-src 'self' 'report-sample'; style-src 'self'; worker-src
+ 'none'; upgrade-insecure-requests; report-uri https://q.stripe.com/csp-violation?q=sWm4IbcEYjYbWSo1i3U3x_5wgMFOdaTC2vtTQgoGOCWGZOsJeSccRQ09CBoSyTug71Md4KMeuD9EdEWh;
+ report-to csp
+ Idempotency-Key:
+ - 621d94b1-f1b6-4c1a-930e-891e419082c0
+ Original-Request:
+ - req_810TJO6HMtxaEu
+ Report-To:
+ - '{"group":"csp","max_age":8640,"endpoints":[{"url":"https://q.stripe.com/csp-report-v2?q=sWm4IbcEYjYbWSo1i3U3x_5wgMFOdaTC2vtTQgoGOCWGZOsJeSccRQ09CBoSyTug71Md4KMeuD9EdEWh&t=1"}],"include_subdomains":true}'
+ Reporting-Endpoints:
+ - csp="https://q.stripe.com/csp-report-v2?q=sWm4IbcEYjYbWSo1i3U3x_5wgMFOdaTC2vtTQgoGOCWGZOsJeSccRQ09CBoSyTug71Md4KMeuD9EdEWh&t=1"
+ Request-Id:
+ - req_810TJO6HMtxaEu
+ Stripe-Notice:
+ - You are using an outdated API version (2023-10-16). We recommend upgrading
+ to the latest API version, 2026-07-29.dahlia. See https://docs.stripe.com/upgrades
+ Stripe-Should-Retry:
+ - 'false'
+ Stripe-Version:
+ - '2023-10-16'
+ Vary:
+ - Origin
+ X-Stripe-Priority-Routing-Enabled:
+ - 'true'
+ X-Stripe-Routing-Context-Priority-Tier:
+ - api-testmode
+ X-Wc:
+ - 3c3
+ Strict-Transport-Security:
+ - max-age=63072000; includeSubDomains; preload
+ body:
+ encoding: UTF-8
+ string: |-
+ {
+ "object": "account_link",
+ "created": 1787840736,
+ "expires_at": 1787841036,
+ "url": "https://connect.stripe.com/setup/e/acct_1U94FFIJXFd0G4T5/bXwCqEp50HeZ"
+ }
+ recorded_at: Thu, 27 Aug 2026 14:25:36 GMT
+recorded_with: VCR 6.4.0
diff --git a/spree/providers/stripe/spec/vcr/seller_payout_account_link_records_account.yml b/spree/providers/stripe/spec/vcr/seller_payout_account_link_records_account.yml
new file mode 100644
index 0000000000..b287021e46
--- /dev/null
+++ b/spree/providers/stripe/spec/vcr/seller_payout_account_link_records_account.yml
@@ -0,0 +1,343 @@
+---
+http_interactions:
+- request:
+ method: post
+ uri: https://api.stripe.com/v1/accounts
+ body:
+ encoding: UTF-8
+ string: country=US&business_profile[name]=Sparks+Audio&controller[fees][payer]=application&controller[losses][payments]=application&controller[stripe_dashboard][type]=express&capabilities[transfers][requested]=true&settings[payouts][schedule][interval]=manual&metadata[spree_seller_id]=1
+ headers:
+ User-Agent:
+ - Stripe/v1 RubyBindings/18.4.2 Spree Stripe/6.0.0.alpha (https://spreecommerce.org)
+ AIAgent/claude_code
+ Authorization:
+ - Bearer <STRIPE_SECRET_KEY>
+ X-Stripe-Client-Telemetry:
+ - '{"last_request_metrics":{"request_id":"req_810TJO6HMtxaEu","request_duration_ms":472}}'
+ Idempotency-Key:
+ - spree-seller-sel_UkLWZg9DAJ-1787840736
+ Stripe-Version:
+ - '2023-10-16'
+ X-Stripe-Client-User-Agent:
+ - "<FILTERED>"
+ Content-Type:
+ - application/x-www-form-urlencoded
+ Accept-Encoding:
+ - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+ Accept:
+ - "*/*"
+ response:
+ status:
+ code: 200
+ message: OK
+ headers:
+ Server:
+ - nginx
+ Date:
+ - Thu, 27 Aug 2026 14:25:38 GMT
+ Content-Type:
+ - application/json
+ Content-Length:
+ - '3562'
+ Connection:
+ - keep-alive
+ Access-Control-Allow-Credentials:
+ - 'true'
+ Access-Control-Allow-Methods:
+ - GET, HEAD, PUT, PATCH, POST, DELETE
+ Access-Control-Allow-Origin:
+ - "*"
+ Access-Control-Expose-Headers:
+ - Request-Id, Stripe-Manage-Version, Stripe-Should-Retry, X-Stripe-External-Auth-Required,
+ X-Stripe-Privileged-Session-Required
+ Access-Control-Max-Age:
+ - '300'
+ Cache-Control:
+ - no-cache, no-store
+ Content-Security-Policy:
+ - base-uri 'none'; default-src 'none'; form-action 'none'; frame-ancestors 'none';
+ img-src 'self'; script-src 'self' 'report-sample'; style-src 'self'; worker-src
+ 'none'; upgrade-insecure-requests; report-uri https://q.stripe.com/csp-violation?q=sWm4IbcEYjYbWSo1i3U3x_5wgMFOdaTC2vtTQgoGOCWGZOsJeSccRQ09CBoSyTug71Md4KMeuD9EdEWh;
+ report-to csp
+ Idempotency-Key:
+ - spree-seller-sel_UkLWZg9DAJ-1787840736
+ Original-Request:
+ - req_0DYeozIHE6nm5X
+ Report-To:
+ - '{"group":"csp","max_age":8640,"endpoints":[{"url":"https://q.stripe.com/csp-report-v2?q=sWm4IbcEYjYbWSo1i3U3x_5wgMFOdaTC2vtTQgoGOCWGZOsJeSccRQ09CBoSyTug71Md4KMeuD9EdEWh&t=1"}],"include_subdomains":true}'
+ Reporting-Endpoints:
+ - csp="https://q.stripe.com/csp-report-v2?q=sWm4IbcEYjYbWSo1i3U3x_5wgMFOdaTC2vtTQgoGOCWGZOsJeSccRQ09CBoSyTug71Md4KMeuD9EdEWh&t=1"
+ Request-Id:
+ - req_0DYeozIHE6nm5X
+ Stripe-Notice:
+ - '2 notices for this request: (1) You are using an outdated API version (2023-10-16).
+ We recommend upgrading to the latest API version, 2026-07-29.dahlia. See https://docs.stripe.com/upgrades
+ (2) We recommend building your integration using Accounts v2. See https://docs.stripe.com/api/v2/core/accounts'
+ Stripe-Should-Retry:
+ - 'false'
+ Stripe-Version:
+ - '2023-10-16'
+ Vary:
+ - Origin
+ X-Stripe-Priority-Routing-Enabled:
+ - 'true'
+ X-Stripe-Routing-Context-Priority-Tier:
+ - api-testmode
+ X-Wc:
+ - 3c3
+ Strict-Transport-Security:
+ - max-age=63072000; includeSubDomains; preload
+ body:
+ encoding: UTF-8
+ string: |-
+ {
+ "id": "acct_1U94FIElKXpnrYly",
+ "object": "account",
+ "business_profile": {
+ "annual_revenue": null,
+ "estimated_worker_count": null,
+ "mcc": null,
+ "minority_owned_business_designation": null,
+ "name": "Sparks Audio",
+ "product_description": null,
+ "specified_commercial_transactions_act_url": null,
+ "support_address": null,
+ "support_email": null,
+ "support_phone": null,
+ "support_url": null,
+ "url": null
+ },
+ "business_type": null,
+ "capabilities": {
+ "transfers": "inactive"
+ },
+ "charges_enabled": false,
+ "controller": {
+ "fees": {
+ "payer": "application"
+ },
+ "is_controller": true,
+ "losses": {
+ "payments": "application"
+ },
+ "requirement_collection": "stripe",
+ "stripe_dashboard": {
+ "type": "express"
+ },
+ "type": "application"
+ },
+ "country": "US",
+ "created": 1787840737,
+ "default_currency": "usd",
+ "details_submitted": false,
+ "email": null,
+ "external_accounts": {
+ "object": "list",
+ "data": [],
+ "has_more": false,
+ "total_count": 0,
+ "url": "/v1/accounts/acct_1U94FIElKXpnrYly/external_accounts"
+ },
+ "future_requirements": {
+ "alternatives": [],
+ "current_deadline": null,
+ "currently_due": [],
+ "disabled_reason": null,
+ "errors": [],
+ "eventually_due": [],
+ "past_due": [],
+ "pending_verification": []
+ },
+ "login_links": {
+ "object": "list",
+ "data": [],
+ "has_more": false,
+ "total_count": 0,
+ "url": "/v1/accounts/acct_1U94FIElKXpnrYly/login_links"
+ },
+ "metadata": {
+ "spree_seller_id": "1"
+ },
+ "payouts_enabled": false,
+ "requirements": {
+ "alternatives": [],
+ "current_deadline": null,
+ "currently_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "disabled_reason": "requirements.past_due",
+ "errors": [],
+ "eventually_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "past_due": [
+ "business_profile.url",
+ "business_type",
+ "external_account",
+ "tos_acceptance.date",
+ "tos_acceptance.ip"
+ ],
+ "pending_verification": []
+ },
+ "settings": {
+ "bacs_debit_payments": {
+ "display_name": null,
+ "service_user_number": null
+ },
+ "branding": {
+ "icon": null,
+ "logo": null,
+ "primary_color": null,
+ "secondary_color": null
+ },
+ "card_issuing": {
+ "tos_acceptance": {
+ "date": null,
+ "ip": null
+ }
+ },
+ "card_payments": {
+ "decline_on": {
+ "avs_failure": false,
+ "cvc_failure": false
+ },
+ "statement_descriptor_prefix": "SPARKS AUD",
+ "statement_descriptor_prefix_kana": null,
+ "statement_descriptor_prefix_kanji": null
+ },
+ "dashboard": {
+ "display_name": "Sparks Audio",
+ "timezone": "Etc/UTC"
+ },
+ "invoices": {
+ "default_account_tax_ids": null,
+ "hosted_payment_method_save": "offer"
+ },
+ "payments": {
+ "statement_descriptor": "SPARKS AUDIO",
+ "statement_descriptor_kana": null,
+ "statement_descriptor_kanji": null
+ },
+ "payouts": {
+ "debit_negative_balances": true,
+ "schedule": {
+ "delay_days": 2,
+ "interval": "manual"
+ },
+ "statement_descriptor": null
+ },
+ "sepa_debit_payments": {}
+ },
+ "tos_acceptance": {
+ "date": null,
+ "ip": null,
+ "user_agent": null
+ },
+ "type": "none"
+ }
+ recorded_at: Thu, 27 Aug 2026 14:25:38 GMT
+- request:
+ method: post
+ uri: https://api.stripe.com/v1/account_links
+ body:
+ encoding: UTF-8
+ string: account=acct_1U94FIElKXpnrYly&refresh_url=https%3A%2F%2Fexample.test%2Fonboarding&return_url=https%3A%2F%2Fexample.test%2Fonboarding&type=account_onboarding
+ headers:
+ User-Agent:
+ - Stripe/v1 RubyBindings/18.4.2 Spree Stripe/6.0.0.alpha (https://spreecommerce.org)
+ AIAgent/claude_code
+ Authorization:
+ - Bearer <STRIPE_SECRET_KEY>
+ X-Stripe-Client-Telemetry:
+ - '{"last_request_metrics":{"request_id":"req_0DYeozIHE6nm5X","request_duration_ms":2072}}'
+ Idempotency-Key:
+ - c039d94a-3e7a-4475-b2c3-1743687b655c
+ Stripe-Version:
+ - '2023-10-16'
+ X-Stripe-Client-User-Agent:
+ - "<FILTERED>"
+ Content-Type:
+ - application/x-www-form-urlencoded
+ Accept-Encoding:
+ - gzip;q=1.0,deflate;q=0.6,identity;q=0.3
+ Accept:
+ - "*/*"
+ response:
+ status:
+ code: 200
+ message: OK
+ headers:
+ Server:
+ - nginx
+ Date:
+ - Thu, 27 Aug 2026 14:25:38 GMT
+ Content-Type:
+ - application/json
+ Content-Length:
+ - '165'
+ Connection:
+ - keep-alive
+ Access-Control-Allow-Credentials:
+ - 'true'
+ Access-Control-Allow-Methods:
+ - GET, HEAD, PUT, PATCH, POST, DELETE
+ Access-Control-Allow-Origin:
+ - "*"
+ Access-Control-Expose-Headers:
+ - Request-Id, Stripe-Manage-Version, Stripe-Should-Retry, X-Stripe-External-Auth-Required,
+ X-Stripe-Privileged-Session-Required
+ Access-Control-Max-Age:
+ - '300'
+ Cache-Control:
+ - no-cache, no-store
+ Content-Security-Policy:
+ - base-uri 'none'; default-src 'none'; form-action 'none'; frame-ancestors 'none';
+ img-src 'self'; script-src 'self' 'report-sample'; style-src 'self'; worker-src
+ 'none'; upgrade-insecure-requests; report-uri https://q.stripe.com/csp-violation?q=sWm4IbcEYjYbWSo1i3U3x_5wgMFOdaTC2vtTQgoGOCWGZOsJeSccRQ09CBoSyTug71Md4KMeuD9EdEWh;
+ report-to csp
+ Idempotency-Key:
+ - c039d94a-3e7a-4475-b2c3-1743687b655c
+ Original-Request:
+ - req_EzTVh89M6ZSZlE
+ Report-To:
+ - '{"group":"csp","max_age":8640,"endpoints":[{"url":"https://q.stripe.com/csp-report-v2?q=sWm4IbcEYjYbWSo1i3U3x_5wgMFOdaTC2vtTQgoGOCWGZOsJeSccRQ09CBoSyTug71Md4KMeuD9EdEWh&t=1"}],"include_subdomains":true}'
+ Reporting-Endpoints:
+ - csp="https://q.stripe.com/csp-report-v2?q=sWm4IbcEYjYbWSo1i3U3x_5wgMFOdaTC2vtTQgoGOCWGZOsJeSccRQ09CBoSyTug71Md4KMeuD9EdEWh&t=1"
+ Request-Id:
+ - req_EzTVh89M6ZSZlE
+ Stripe-Notice:
+ - You are using an outdated API version (2023-10-16). We recommend upgrading
+ to the latest API version, 2026-07-29.dahlia. See https://docs.stripe.com/upgrades
+ Stripe-Should-Retry:
+ - 'false'
+ Stripe-Version:
+ - '2023-10-16'
+ Vary:
+ - Origin
+ X-Stripe-Priority-Routing-Enabled:
+ - 'true'
+ X-Stripe-Routing-Context-Priority-Tier:
+ - api-testmode
+ X-Wc:
+ - 3c3
+ Strict-Transport-Security:
+ - max-age=63072000; includeSubDomains; preload
+ body:
+ encoding: UTF-8
+ string: |-
+ {
+ "object": "account_link",
+ "created": 1787840738,
+ "expires_at": 1787841038,
+ "url": "https://connect.stripe.com/setup/e/acct_1U94FIElKXpnrYly/u92ZwfigWwNw"
+ }
+ recorded_at: Thu, 27 Aug 2026 14:25:38 GMT
+recorded_with: VCR 6.4.0