Transfer Related Errors

This section also includes failure reasons for our different payment rails (Return Reasons for ACH, and Reject Codes for Instant Payments (RTP)). Please refer to the respective Payment Rails guides for additional context.

Generic Transfer Errors

Code	Title	Detail
3000	Unknown transfer uid	Could not find transfer. Invalid uid.
3001	Could not initiate transfer	An exception occurred while creating transfer.
3002	Could not initiate transfer	Requested transfer amount in US dollars must be numeric.
3003	Could not initiate transfer	Requested transfer amount in US dollars must be greater than 0.
3004	Could not initiate transfer	Source has insufficient funds for transfer.
3005	Same source and destination accounts	The source and destination accounts are identical.
3006	Could not initiate transfer	Requested transfer between the chosen accounts is prohibited.
3007	Source or Destination Account is discarded	Transfers to or from a discarded account are not allowed.
3008	Source or Destination Account is locked	Transfers to or from a locked account or an account that belongs to a locked customer are prohibited.
3010	Customer daily external transfer request maximum has been reached	The maximum number of daily external transfers defined in the Program configuration has been reached.
3011	Customer daily external transfer amount has been reached	This transfer request exceeds the customer's daily external transfer US dollar amount limit.
3012	Transfer amount exceeds program maximum	This transfer exceeds the maximum dollar amount allowed in the Program configuration.
3013	Transfer amount below program minimum	This transfer does not meet the minimum dollar amount required in the Program configuration.
3014	Failed to retrieve transfers	An exception occurred while retrieving transfers.
3015	Could not initiate transfer	An exception occurred while creating the custodial transfer.
3016	Source or Destination Account is inactive	Transfers to or from an account not in 'active' status are prohibited.
3017	Transfer amount exceeds program limit	Transfer amount exceeds program config limit for any transfer
3018	Transfer amount would exceed the cumulative credit limit	Transfer amount would exceed the cumulative credit amount limit.
3019	Invalid usd_transfer_amount value	Requested transfer amount in US dollars cannot have more than 2 decimal places.
3020	Transfers are not supported for secondary customers	Transfers are only supported for primary (account-holding) customers.
3021	Maximum customer balance has reached	This Transfer request would result in the customer's total balance exceeding the configured maximum allowed balance
3031	Invalid `initiator_type`	The initiating user must be a `customer` for ACH Transfers
3032	Transmitter information is required	Transmitter information is required to complete this Transfer, and the fields were either null or invalid
3034	Transfer external uid is already taken	Transfer external uid must be unique