How Stripe payouts work

Learn how marketplace providers receive money from transaction payments

Yifan Dong avatar
Written by Yifan Dong
Updated over a week ago

A payout refers to the stage in the payment process where the transaction amount is transferred to the provider's bank account. One of the key functionalities of Sharetribe is facilitating payments from customers for their orders and ensuring the transfer of these funds to the bank accounts of listing providers.

What is the difference between a payment and a payout?

A payment happens when the transaction's checkout is initiated. This is the moment when the customer adds their credit card information, and their card is charged. After a payment, the money is held in Stripe's system until the payout happens. As mentioned above, a payout is the action of sending the money from Stripe's system to the provider's bank account.

What happens after a payment?

After a payment occurs in a transaction using Stripe as the payment processor, Stripe holds the money from the payment before a payout to the provider is triggered.

How the payout triggers depends on the transaction settings in the associated transaction.

Calendar booking: The payout is triggered 2 days after the end of the booking period (i.e., if the booking ends on Monday, the payout is triggered on Wednesday)

Purchase: The payout can be triggered in one of two ways when:

1) The buyer marks the order as received

2) The transaction automatically marks itself as completed 14 days after the provider marks the order as delivered (or shipped).

What happens after a payout is triggered?

After a payout is triggered, Stripe will begin the process of transferring the funds to the provider's bank account, which is connected to their payout settings on the marketplace. It can take Stripe anywhere between 5 to 10 business days to transfer the money to the provider's bank account. Moreover, there may be additional days of standard bank processing time before the balance appears in the provider's bank account statement.

Can the funds from a payment be held longer?

With Stripe, funds from payment can be held for up to 90 days (and 2 years for US-based accounts). The default number of days that it takes for the payout to trigger can be changed with code customization by modifying the transaction process.

Should my payout setting in Stripe be manual or automatic?

The Sharetribe Stripe integration requires a "manual payout" setting within Stripe because the Stripe engine does not control the payouts. Instead, payouts are defined by the transaction process within Sharetribe. Sharetribe's system triggers the payouts. From Stripe's point of view, payouts are manual (i.e., defined by an outside system), but from the marketplace's point of view, payouts are automatic (i.e., you do not need to go to the Stripe dashboard to make payouts),

This means that you need to set the payout to "MANUAL" from your stripe dashboard. If they are set to "automatic," your Stripe integration with Sharetribe will not work as intended.

Can I view an estimated payout time?

If Stripe already initiated the payout, you can view the estimated date of when the payout should arrive in your provider's bank account in your Stripe dashboardPayments tab→ Open the payment page → click on "Transfer destination" under the Payment details section → In the money movement > Payouts tab, there should be an EST. ARRIVAL date.

The payout failed, what do I do?

A payout may fail due to various reasons. For a detailed explanation of these potential causes, please consult our documentation on payout failures.

Did this answer your question?