Skip to content
Create account
or
Sign in
The Stripe Docs logo
/
Ask AI
Create account
Sign in
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Developer tools
Get started
Payments
Finance automation
Get started
Payments
Finance automation
Platforms and marketplaces
Money management
Overview
Start an integration
Products
Global Payouts
    Overview
    Get started
    Fund your storage balance
    Create recipients
    Send money
    Manage Global Payouts
    Test Global Payouts
    Pricing
    Compare with Connect
Capital
Issuing cards
Treasury
Manage money
HomeMoney managementGlobal Payouts

Get started with Global PayoutsPublic preview

Learn how to set up your Global Payouts integration.

Copy page

Before you start sending payouts, you must activate and configure your account, payout, and communication settings. You can then fund and send money from the Stripe Dashboard, using Stripe-hosted forms, or with the API.

Activate and configure your account

  1. In the Dashboard, navigate to More > Global Payouts, then click Get started.
  2. Sign the Global Payouts Terms of Service. If required, you might be prompted to provide additional information. In some cases, we might need to verify your information, which can take a few business days.

You’ll receive an email confirming that you can start sending payouts.

Add team members

Give team members access to Global Payouts by assigning them to one of Stripe’s existing roles. Team members in the Administrator, Developer, Analyst, and View-only roles have varying levels of access to Global Payouts.

Configure payout settings (Optional)

You can choose the payout method for each payout, or set a global default method. Default preferences apply to newly created payouts and newly created recipients. To set a default payout method:

  1. Navigate to Settings > Payments, then click Global Payouts.
  2. Enable at least one payout method.
  3. Click Done.

You can override these settings with the API or in the Dashboard.

Add or remove payout methods

You can add or remove payout methods for an individual recipient.

  1. Navigate to Recipients and select the recipient you want to edit.
  2. In Payout methods, click Edit and enable the methods you want to use. If you selected a new payout method, you might need to collect more information from the recipient.
    • For Local network, you must provide the recipient’s bank account and routing number.
    • For Wire transfer, you must provide the recipient’s address and wire routing number.
    • For Instant, the recipient must provide their debit card information.
  3. Click Done.

Set communication preferences (Optional)

Global communication preferences determine how Stripe can communicate on your behalf with recipients. You can override these settings with the API or in the Dashboard.

To set default communication preferences for all recipients:

  1. Navigate to Settings > Payments, then click Global Payouts.
  2. In Recipient communication permissions, choose whether you want Stripe to email recipients on your behalf or if you plan to handle communications with recipients yourself.

Fund your balance and send money

Use the Stripe Dashboard or API to start sending money:

  1. Fund your storage balance
  2. Create a recipient
  3. Send money

Core concepts for API integrations

Global Payouts use the Stripe API v2 for payouts, which differs from the API v1. If you’re sending money using the API, review the following information:

  1. Learn more about the API v2 and associated concepts:
    • Sandboxes
    • Workbench
    • Event destinations
  2. Install the SDK for the API v2.
  3. To receive Stripe events for Global Payouts, configure your endpoint to receive thin events.

Use the following core concepts to build and manage payouts:

ConceptDescription
FinancialAccountA balance that you use as the source or destination of the v2 Money Movement API. We refer to this as a “storage balance.” After you activate Global Payouts, we automatically create a FinancialAccount for you. US Financial Accounts are eligible for FDIC insurance.
TransactionA statement-level description of balance changes on a FinancialAccount.
FinancialAddressCredentials that you can use to transfer funds from a bank account into Stripe.
InboundTransferFunds that you pulled into your FinancialAccount from a bank account. Includes metadata about the sender and the transfer mechanism.
ReceivedCreditFunds you sent into your FinancialAccount from a bank account or Balance v1. Includes metadata about the sender and the transfer mechanism.
AccountA company or individual that you do business with. Configure the Account as a recipient to receive payouts.
PayoutMethodA payment instrument for you and your recipients. Typically used with the Outbound Payments API.
OutboundPaymentA payment of funds from the FinancialAccount to a recipient’s PayoutMethod. Tracks the lifecycle of a payment.
OutboundTransferA withdrawal of funds from the FinancialAccount to your own PayoutMethod. Tracks the lifecycle of the withdrawal.
AccountLinkA single-use Stripe URL that redirects your user to a Stripe-hosted application to complete onboarding, such as Stripe-hosted recipient information collection.
Was this page helpful?
YesNo
Need help? Contact Support.
Join our early access program.
Check out our changelog.
Questions? Contact Sales.
LLM? Read llms.txt.
Powered by Markdoc