Create a Global Payout recipient with the APIPublic preview

Build an information collection flow for your recipients to collect recipient and payout method details, and then pass that information to Stripe through our APIs.

Considerations

Your business is responsible for all interactions with your recipients and for collecting all the necessary information to verify them. Stripe updates recipient verification requirements as laws and regulations change around the world.

When building a payout integration, consider how to handle:

• Regularly reviewing changes to legal and regulatory requirements.
• Updating your application logic in response to these changes.

Plan to review and update onboarding requirements on a regular basis to avoid payout failures.

Create a recipient

When using a form to collect payout recipient information, use the Accounts API v2 to create a recipient. You must provide the following parameters to create the Account ID:

You must specify your intended payout method types by requesting the corresponding capabilities when you create the Account.

A recipient can have multiple payout method types enabled. Not all payout method types are available for recipients in all countries. See the full list of available payout methods by country.

Some capabilities require additional information about your recipient. For example, configuration.recipient.capabilities.bank_accounts.local for a US recipient requires you to submit an account and routing number. After you request payout method capabilities, Stripe determines the additional information requirements that you need to submit to enable them and can identify it in the API response. To receive the requirements in the response, include requirements, configuration.recipient, and identity in the include array. Otherwise, Stripe returns a null response for those properties, regardless of their actual values.

curl -X POST https://api.stripe.com/v2/core/accounts \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-01-28.preview" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "identity": {
        "country": "us",
        "entity_type": "individual"
    },
    "configuration": {
        "recipient": {
            "capabilities": {
                "bank_accounts": {
                    "local": {
                        "requested": true
                    }
                }
            }
        }
    },
    "include": [
        "identity",
        "configuration.recipient",
        "requirements"
    ]
  }'

Determine required fields to activate a recipient

To identify the specific requirements that you must submit, inspect the requirements.entries array in the Accounts API response. For the recipient to accept payouts, you must provide all requirements that have the restricts_capabilities property.

{
 "id": "{{CONNECTED_ACCOUNT_ID}}",
 "object": "v2.core.account",
 "applied_configurations": [
   "recipient"
 ],
 "configuration": {
   "customer": null,
   "merchant": null,
   "recipient": {

Submit recipient information to Stripe

After you collect the required information, use the Accounts API to submit it.

curl -X POST https://api.stripe.com/v2/core/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-01-28.preview" \
  --json '{
    "contact_email": "jenny.rosen@example.com",
    "display_name": "Jenny Rosen",
    "identity": {
        "country": "us",
        "entity_type": "individual",
        "individual": {
            "given_name": "Jenny",
            "surname": "Rosen",
            "address": {
                "city": "Brothers",
                "country": "US",
                "line1": "27 Fredrick Ave",
                "postal_code": "97712",
                "state": "OR"
            }
        }
    },
    "include": [
        "identity"
    ]
  }'

Confirm that the recipient is enabled

Retrieve the Account and inspect the status of the capabilities you’ve requested. The status of a payout method capability must be active for the recipient to receive payouts by that method.

curl -G https://api.stripe.com/v2/core/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-01-28.preview" \
  -d "include[0]"="configuration.recipient"

Create payout methods for your recipients

After enabling a payout method capability, use the Outbound Setup Intents API to create the recipient’s actual PayoutMethod.

The Stripe-Context header in this request must be the recipient’s account ID.

curl -X POST https://api.stripe.com/v2/money_management/outbound_setup_intents \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-01-28.preview" \
  -H "Stripe-Context: 
{{CONTEXT}}
" \
  --json '{
    "payout_method_data": {
        "type": "bank_account",
        "bank_account": {
            "country": "FR",
            "account_number": "FR76300060000112345678901234"
        }
    }
  }'

To send payouts by wire transfer, use the US Bank Accounts API to add the fedwire_routing_number to the PayoutMethod. Additional fees apply. See pricing for details.

You can also use debit cards as a payout method. However, your recipients must submit their debit card information directly to Stripe. If you’re interested in enabling payouts by debit cards, use the Account Links API to create a shareable form for your user to submit their debit card credentials.

View all payout methods for a recipient

Use the Payout Methods API to retrieve a recipient’s PayoutMethods.

The Stripe-Context header in this request must be the recipient’s Account ID.

curl https://api.stripe.com/v2/money_management/payout_methods \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2026-01-28.preview" \
  -H "Stripe-Context: 
{{CONTEXT}}
"

The response contains a list of PayoutMethod objects associated with the recipient. Use a PayoutMethod ID to make a payout using the Outbound Payments API. See Send money for more details.