Delayed Payouts

Permission required to use this feature - please contact your account manager.


Charge a payer but don't let the merchant withdraw the funds to their bank account until some trigger condition is met. This is different from Tipping Point Payments where a payer's credit card information is collected but not charged until a tipping point or trigger condition is met.

Delayed payouts are available only in the United States and Canada at this time.


Assume you are a platform that helps small businesses sell their goods. Someone orders a physical good from one of your small businesses. You want to charge the payer immediately, but you don't want to release the funds to the small business until the item is shipped.

At WePay, the small business is the merchant and buyers are payers and we'll use those terms below.

Key Concepts

You will charge the customer like normal with the /checkout/create call, and set the auto_release flag to false to indicate that you want the payment captured. Once you want the payment to be made available to the merchant, you will make another API call (/checkout/release).

There are two options to facilitate charging the card for delayed payouts.

  • Iframe - Iframe uses the /checkout/create API call to obtain a checkout_uri which will be embedded on your site to let the payer complete the payment. This method lets you use WePay's pre-built and optimized form to collect credit card information. This method minimizes necessary PCI compliance, because information is shared securely between the browser and WePay.
  • Tokenization - Tokenization uses WePay's tokenization.js to obtain a credit card token which can then be used to charge the card with the /checkout/create API call. This method lets you use your own form to collect credit card information. As there is exposure to developer error or fraud, there is more PCI compliance required than there is with iframe.

Important Note: It is important to know that you can only delay payout for 14 days. If the payment has not been released 14 days after initial payment, it will be refunded. If your use-case needs to delay payout for longer than 14 days, then you might want to take a look at tipping-point payments.