Manage payoutsPublic preview

Learn how to monitor payout statuses and reports.

After you create a payout, you can view its status, receive events when the status changes, reverse the payout, and view reporting.

View payout status

You can view a payout’s status in the Dashboard or with the API by inspecting its status.

In the Stripe Dashboard, navigate to Global Payouts.
Use the filter buttons to sort payouts by processing, posted, failed, returned, or canceled.

You can also view an itemized receipt that includes details of the payout.

Payout statuses

The following table describes the possible payout statuses.

Status	Description
processing	The starting state of the payout. Funds allocate to a pending transaction and remain part of the current `outbound_pending` balance. If the value of the cancelable parameters is set to `true`, you can cancel the payout.
failed	The payout failed. Stripe voids the pending transaction and returns the funds to you.
canceled	The payout was canceled before it posted. Stripe voids the pending transaction and returns the funds to you.
posted	The payout posts and funds leave the FinancialAccount. Posted doesn’t guarantee that your recipient has received money, because their bank might delay the release of funds. If a payout is posted but the recipient hasn’t received money, instruct them to wait several business days or to inquire with their bank.
returned	The payout failed to arrive at the destination. Stripe returns the funds to you in a separate transaction (`returned_details[transaction]`). To see the return reason, on the Global Payouts page, click the payout in the list view and see the return reason listed in the Timeline section. You can also view return reasons in OutboundPayments. Payouts are typically returned within 2-3 business days, but might take longer depending on the recipient country.

View changes in payout state

You can view changes in payout state in the Dashboard or by receiving events to your webhook endpoint.

In the Dashboard, navigate to Global Payouts.
Find the Payout that you want to inspect, and select it.
View the Timeline section to see a record of state changes.

Manage returned payouts

Incorrect destination information causes most returned payouts (for example, the provided bank account is closed, or the account holder’s details don’t match the recipient’s information). If a payout has been returned:

Read the return reason. You can view it in the Dashboard by selecting the payout in the list view and reading through the Timeline section. You can also view return reasons in OutboundPayments.
If the payout returned because of incorrect destination information, confirm the details and ask the recipient to update their information if needed. Then, send a new payout to their updated destination.
If the payout returned for an unknown failure, confirm the details and ask the recipient to update their information if needed. Then, try sending the money again. If the payout still fails, contact Stripe Support.

Cancel or reverse a payout

If you unintentionally send a payout, you might be able to cancel the payout if it hasn’t been initiated. You can do this using the Dashboard or API.

If the payout posts, you can still request a reversal by emailing Stripe support if your payout method supports it. Stripe makes an attempt to reverse the payout and return the funds to your account. Stripe can’t guarantee a reversal, and some payout methods aren’t reversible.

US domestic payouts (local bank transfer): You must request a reversal within 24 hours of creating the payout.
US domestic payouts (wire): You must request a reversal within 24 hours of creating the payout.
UK domestic payouts (local bank transfer): Payout reversals aren’t supported.
Cross-border payouts: Payout reversals aren’t supported.

View reports and transactions

You can use the Dashboard and API to view your account balance and reports, view transactions to and from the balance, and withdraw funds.

Navigate to Payouts and click Export to export a CSV file of historical payout information. You can select your preferred time zone, date range, and desired columns. You can also download reports from Balances. It takes 96 hours for fees and 24 hours for general activity to reflect in these reports.

You can also view a summary of payouts activity in Reports. Click Financial account balance summary and download the Balance summary, or the Balance change from activity. You can select your preferred time zone, date range, and desired columns.

Private preview

Sigma or Stripe Data Pipeline reporting with Global Payouts is in private preview. If you’re interested in getting access,

enter your email.