Payout failure codes
Failure reasons when a payout fails to process
Early PreviewThis feature is currently in Beta. Please contact Rainforest support or your Platform Success Manager for more information on Payouts.
When a payout cannot be submitted, it moves to the status of Failed and the amount goes back to the merchant's available balance. The payout's failure_code and failure_desc explain the reason for the failure.
A payout that the payout receiver's bank rejects after it was sent is Returned, not Failed, and carries an ACH return code instead.
Failure codes
| Failure code | Description | How to resolve |
|---|---|---|
PAYOUT_RECEIVER_INACTIVE | The payout receiver is not active and cannot receive payouts. | Check the payout receiver's status. If they were deactivated, create the payout to an active payout receiver. |
PAYOUT_RECEIVER_NEEDS_METHOD | The payout receiver does not have an active bank account. | Add and verify a new bank account on the payout receiver, then create a new payout. |
MERCHANT_INACTIVE | The merchant is not active and cannot send payouts. | Contact Rainforest support. |
FAILED | The payout failed to process. | Contact Rainforest support. |
Updated about 21 hours ago
Did this page help you?