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

Test Global PayoutsPublic preview

Learn how to test Global Payouts in a sandbox environment.

Copy page

To confirm your integration works, you can simulate sending payouts in a test environment.

Sandboxes

In the Stripe Dashboard, navigate to a Sandbox to test the Global Payouts functionality without affecting your live integration. Learn more about Sandboxes.

Use sandbox API key

Use a sandbox API key to test your integration. Sandbox API keys contain the sk_test_ prefix and live mode secret keys contain the sk_live_ prefix. Keys associated with a sandbox can only operate on objects in that sandbox.

  1. Navigate to Developers, and click API keys.
  2. Under Standard keys, locate your secret test key.

Set up your sandbox

  1. In the Dashboard, click the account picker, and choose Create sandbox. If you have an existing sandbox, select that sandbox.
  2. On the Global Payouts page, click Get started to begin testing.

You can exit the sandbox and return to your live mode account from the account picker.

Additional sandboxes

You can create additional sandboxes using the instructions above. Additional sandboxes that you create don’t have payouts activated by default.

Fund your sandbox

You can use your sandbox storage balance to test the funding options for Global Payouts.

Send funds from your external bank account

Use the Dashboard or a test helper API with your sandbox API key to simulate receiving funds into your storage balance from an external bank account.

If you don’t see a sandbox banner at the top of the Dashboard, use the account picker to select a sandbox to use.

  1. On the Balances tab, click Move money, then select Add money for payouts.
  2. Click View external funding instructions.
  3. Click Request account details to see where to send funds. Stripe generates your account details within a few minutes and emails you when they’re ready.
  4. When the sandbox shortcut is enabled, add an amount, then click Add money.

Pull funds from your external bank account US only

Stripe attaches a verified bank account to your sandbox that you can use to fund your account through the Dashboard or API. Follow the instructions to pull funds from your external bank account using the test credentials in your sandbox, or using the sandbox API key.

Transfer funds from your Stripe balance

Use the Dashboard or API to create a test charge on your account using a test card. The test charge settles immediately into the available balance to avoid simulated delays.

Make sure to use:

  • A valid future date, such as 12/34
  • Any 3-digit number for the CVC field
  • Any value you want for the other form fields
DescriptionNumberDetails
Bypass pending balanceThe US charge succeeds. Funds are added directly to your available balance, bypassing your pending balance.
Bypass pending balanceThe international charge succeeds. Funds are added directly to your available balance, bypassing your pending balance.

You can transfer funds following the instructions to transfer funds from your Stripe balance.

Create recipient and send money

After enabling Global Payouts on your sandbox and funding the sandbox storage balance, you can create recipients and send money to them. Use test payout credentials to test different scenarios in your sandboxes. These test accounts don’t work in live mode.

Test bank account numbers

If you’re in a sandbox, you can use SM11AA as the verification code.

Routing numberAccount numberBehavior
110000000123456Payout succeeds.
110000111111116Payout fails with a no_account code.
110000111111113Payout fails with an account_closed code.
110000222222227Payout fails with a insufficient_funds code.
110000333333335Payout fails with a debit_not_authorized code.
110000444444440Payout fails with an invalid_currency code.

Test debit cards for instant payouts US only

Only non-prepaid debit cards are supported. Use test debit cards to test different scenarios in your sandboxes. These test accounts don’t work in live mode.

BrandNumberCVCDateBehavior
Visa (debit)4000056655665556Any 3 digitsAny future dateThe payout succeeds.
Mastercard (debit)5200828282828210Any 3 digitsAny future dateThe OutboundPayment succeeds.
Discover (debit)6011981111111113Any 3 digitsAny future dateThe OutboundPayment succeeds.
Visa (credit)4242424242424242Any 3 digitsAny future dateThe payout fails because the card isn’t eligible for a payout.
Mastercard (prepaid)5105105105105100Any 3 digitsAny future dateThe payout fails because the card isn’t eligible for a payout.
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