How can I direct WooCommerce Stripe payments to a connected account instead of the main account?

When collecting payments on behalf of connected accounts, you don’t change an “account ID” in a settings panel—instead, you specify which connected account should receive the payment by including its ID in your API requests.

How to Specify the Connected Account

When you make an API call (for example, creating a charge), include the special header:

BASHCopied
-H "Stripe-Account: acct_ABC123XYZ"  # Replace with the connected account's ID

This tells Stripe that the action (e.g., creating a charge) should apply to that connected account rather than the main or platform account.

Example Using cURL

Here’s a sample cURL request illustrating how to create a charge on behalf of a connected account:

BASHCopied
curl https://api.stripe.com/v1/charges \
  -u sk_test_yourSecretKey: \
  -H "Stripe-Account: acct_ABC123XYZ" \
  -d amount=2000 \
  -d currency=usd \
  -d source=tok_visa \
  -d description="Charge for connected account"

Replace sk_test_yourSecretKey with your API key and acct_ABC123XYZ with the ID of the connected account that should receive the funds.

Additional Details

• No Dashboard Option: There isn’t a setting in the Dashboard to change the account ID for individual API calls. It’s done on a per-request basis by including the header.
• Consistency Across Requests: Once you set the account ID in the request, subsequent methods on the returned object will continue to use that connected account.
• Integration Guides: For more details on how to make API calls on behalf of connected accounts, check out the Making API calls for connected accounts guide in the Stripe documentation.

Since you mentioned you have the skills to adjust the code, you can update or wrap your API requests to dynamically set the connected account’s ID depending on the logic in your application. This will ensure that payments are collected directly by the intended connected account rather than your main account.

Let me know if this helps or if you have any further Stripe API questions!