Payout failure codes

Failure reasons when a payout fails to process

Early Preview

This 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 codeDescriptionHow to resolve
PAYOUT_RECEIVER_INACTIVEThe 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_METHODThe 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_INACTIVEThe merchant is not active and cannot send payouts.Contact Rainforest support.
FAILEDThe payout failed to process.Contact Rainforest support.

Did this page help you?