Webhook Reason Codes
Clients should use the following table to determine whether to retry a
transaction based on the errorCode and errorDescription returned by the
webhook.
| ErrorCode | ErrorDescription | Next action to be taken by clients |
|---|---|---|
| TRANSACTION_FEE_ERROR | Error occurred due to transaction fee exceeding transfer amount | Please retry with higher transaction amount |
| INSUFFICIENT_FUNDS_ERROR | Insufficient funds available in account for transaction processing | Please retry after adding more funds to your account |
| LIMIT_REACHED_ERROR | Payment amount exceeds the monthly limit | Max limit reached for this month. Please retry later |
| LIMIT_REACHED_ERROR | Payment amount exceeds the weekly limit | Max limit exceeded for the week. Please retry later |
| LIMIT_REACHED_ERROR | Payment amount exceeds the daily limit | Max limit exceeded for today. Please retry later |
| LIMIT_REACHED_ERROR | Payment amount exceeds the maximum limit allowed | Amount is greater than allowed limit. Retry with smaller amount |
| LIMIT_REACHED_ERROR | Payment amount is below the minimum limit allowed | Amount is less than allowed limit. Retry with higher amount |
| CONTACT_NOMUPAY_SUPPORT | Please contact Nomupay support team for assistance with this issue | Please reach out to Nomupay Team |
| BANK_REJECTED | Account closed | Please retry later with different account |
| UNSUPPORTED_COUNTRY | Country not found for payout | Please reach out to Nomupay Team |
| BANK_REJECTED | Bank has rejected the transaction | Please reach out to Nomupay Team |
| PARTNER_ERROR | Partner service unavailable | Please retry later |
| INVALID_ENTITIES | Invalid entities | Please retry again with correct request |
| RETRYABLE_ERROR | Non-retryable error occurred due to too many requests | Please retry later after some time |
| BANK_REJECTED | Bank has rejected/returned the transaction | Please reach out to Nomupay Team |
| CASHOUT_SYSTEM_ERROR | Cashout system encountered an error | Please retry later after some time |
| BANK_REJECTED | Beneficiary account number is invalid | Please don’t retry and check beneficiary account details |
| BANK_REJECTED | Beneficiary name is incorrect | Please retry after correcting the beneficiary name details |
| BANK_REJECTED | Country not found for payout | Please reach out to Nomupay Team |
| BANK_REJECTED | Invalid Account Id | Please don’t retry and check beneficiary account details |
| BANK_REJECTED | Invalid Beneficiary bank details | Please don’t retry and check beneficiary bank details |
| BANK_REJECTED | Invalid Beneficiary details | Please don’t retry and check beneficiary bank details |
| BANK_REJECTED | Invalid purpose | Please retry after correcting purpose |
| BANK_REJECTED | Invalid Request | Check account type |
| BANK_REJECTED | Limit exceed | Please retry later with different amount |
| BANK_REJECTED | Limit exceed transaction amount | Please retry later after some time |
| BANK_REJECTED | Payment cancelled/Rejected post approval | Please reach out to Nomupay Team |
| BANK_REJECTED | Invalid beneficiary lastname | Please don’t retry and check beneficiary bank details |