Get started with Global PayoutsVersion bêta publique
Learn how to set up your Global Payouts integration.
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
- In the Dashboard, navigate to More > Global Payouts, then click Get started.
- 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:
- Navigate to Settings > Payments, then click Global Payouts.
- Enable at least one payout method.
- 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.
- Navigate to Directory and select the recipient you want to edit.
- 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.
- 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:
- Navigate to Settings > Payments, then click Global Payouts.
- 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:
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:
- Learn more about the API v2 and associated concepts:
- Install the SDK for the API v2.
- To receive Stripe events for Global Payouts, configure your endpoint to receive thin events.
Use the following core concepts to build and manage payouts:
Concept | Description |
---|---|
FinancialAccount | A 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. |
Transaction | A statement-level description of balance changes on a FinancialAccount. |
FinancialAddress | Credentials that you can use to transfer funds from a bank account into Stripe. |
InboundTransfer | Funds that you pulled into your FinancialAccount from a bank account. Includes metadata about the sender and the transfer mechanism. |
ReceivedCredit | Funds you sent into your FinancialAccount from a bank account or Balance v1. Includes metadata about the sender and the transfer mechanism. |
Account | A company or individual that you do business with. Configure the Account as a recipient to receive payouts. |
PayoutMethod | A payment instrument for you and your recipients. Typically used with the Outbound Payments API. |
OutboundPayment | A payment of funds from the FinancialAccount to a recipient’s PayoutMethod. Tracks the lifecycle of a payment. |
OutboundTransfer | A withdrawal of funds from the FinancialAccount to your own PayoutMethod. Tracks the lifecycle of the withdrawal. |
AccountLink | A single-use Stripe URL that redirects your user to a Stripe-hosted application to complete onboarding, such as Stripe-hosted recipient information collection. |