Overview
Vendy uses standard HTTP response codes to indicate the success or failure of an API request. Generally codes represent the following:
- Codes in the 2xx range indicate success
- Codes in the 4xx range indicate a failure given the information provided
- Codes in the 5xx range indicate an error with the Vendy servers (very uncommon)
In the occurrence of 4xx response code, Vendy will provide a JSON error code message that briefly explains the error.
List of error messages
| Error | Code | Description |
|---|---|---|
| ACCOUNT_NOT_FOUND | 201 | Account not found |
| ACCOUNT_NOT_ACTIVATED | 202 | Account not activated. Check your email to activate it! |
| ACCOUNT_INCORRECT_PASSWORD | 203 | Incorrect password |
| INVALID_DATA | 204 | Data is invalid |
| ACCOUNT_EXISTS | 205 | Account already exists |
| NOT_CREATED | 206 | Data not created |
| NOT_FOUND | 207 | Data not found |
| NOT_UPDATED | 208 | Data not updated |
| ACCOUNT_BLOCKED | 209 | Account blocked |
| LOGIN_FAILED | 210 | Login failed |
| INCORRECT_OTP | 211 | Incorrect OTP |
| OLD_PASSWORD | 212 | New password cannot be same old password |
| PASSWORD_UPDATED | 213 | Password not updated |
| WALLET_NOT_SUPPORTED | 217 | Wallet not supported |
| WEBHOOK_NOT_SUPPORTED | 218 | Webhook not supported |
| WALLET_NOT_CREATED | 219 | Wallet not created |
| WALLET_NOT_IMPORTED | 220 | Wallet not imported |
| WALLETS_NOT_FOUND | 221 | Wallet not found |
| WALLET_ADDRESS_NOT_CREATED | 222 | Wallet address not created |
| TRANSACTION_NOT_BE_CREATED | 223 | Transaction not be created |
| ACTIVATION_CODE_INVALID | 224 | otp is invalid or expired |
| UNAUTHORIZED | 229 | User not logged in |
| ACCOUNT_NOT_RESET | 232 | Password could not be reset |
| EXPIRED_CODE | 234 | Password reset link expired. Please reset password again or contact support |
| INVITE_CODE_INVALID | 235 | Invite code is invalid |
| BALANCE_NOT_RETRIEVED | 244 | Balance not retrieved |
| LOGOUT_FAILED | 247 | Logout failed |
| INVALID_RESET_CODE | 248 | Invalid reset code sent |
| PUSH_TOKEN_EXISTS | 250 | Push token already exists |
| PUSH_NOT_STORED | 251 | Push token not stored |
| BALANCE_INSUFFICIENT | 252 | Your balance is insufficient |
| ONLY_ACCOUNT_IP | 253 | An account has already been created using this IP address |
| METRIC_FAILED | 259 | Metric could not be loaded |
| USER_NOT_FOUND | 265 | User not found |
| RESET_CODE_NOT_FOUND | 272 | Reset code was not found |
| USER_NOT_DELETED | 273 | User account could not be deleted |
| FAILED_GLOBAL_SETTING | 274 | GlobalSetting setting could not be created |
| UPDATED_GLOBAL_SETTING | 275 | GlobalSetting setting could not be updated |
| NO_GLOBAL_SETTING | 276 | GlobalSetting settings could not be retrieved |
| IP_NOT_BLOCKED | 277 | Ip could not be blocked |
| IP_BLOCKED | 278 | IP has been blocked |
| IP_NOT_UNBLOCKED | 278 | IP could not be unblocked |
| BANK_ACCOUNT_EXISTS | 290 | You already have this bank account" }; |
| BANK_ACCOUNT_REMOVED | 291 | Bank cannot be removed |
| BANK_NOT_DEFAULT | 292 | Bank could not be made default |
| TRANSACTION_AMOUNT_INVALID | 293 | Transaction amount does not match payment amount |
| INVALID_SECURITY_ANS | 294 | The security question you provided is incorrect |
| INVALID_ANSWER | 295 | Answer is invalid |
| PAYMENT_NOT_PROCESSED | 297 | Payment could not be processed right now. Please try again later |
| TRANSACTION_NO_PENDING | 298 | No pending transaction found |
| TRANSACTION_STILL_PENDING | 305 | Transaction still processing. Please wait... |
| TRANSACTION_NOT_PROCESSED | 306 | Transaction failed. Please try again later |
| KYC_NOT_VERIFIED | 310 | You account has not been verified. Please complete KYC or contact support |
| BALANCE_NOT_UPDATED | 318 | Balance not updated |
| BUSINESS_NOT_CREATED | 324 | Business not created |
| BUSINESS_NOT_ACTIVE | 325 | Business not active |
| BUSINESS_NOT_FOUND | 326 | Business not found |
| BUSINESS_NOT_DELETED | 326 | Business not deleted |
| TRANSACTION_NOT_FOUND | 327 | Transaction not found |
| BANK_ACCOUNT_NOT_FOUND | 327 | Bank information not resolved |
| PAYOUT_NOT_CREATED | 328 | Payout not created |
| PAYOUT_NOT_FOUND | 329 | Payout not found |
| PAYOUT_ALREADY_PROCESSED | 330 | Payout already processed |
| PAYOUT_NOT_UPDATED | 331 | Payout not created |
| CHANNELS_NOT_FOUND | 332 | Channels not found |
| BUSINESS_NOT_UPDATED | 333 | Business status not pending and cannot be updated |
| WALLET_MULTIPLE_CURRENCY | 334 | You cannot have multiple wallets with the same currency |
| WALLET_MULTIPLE_TYPE | 334 | You cannot have multiple wallets of the same type |
| WALLET_NOT_FUNDED | 335 | Wallet could not be funded |
| WALLET_NOT_DEBITED | 335 | Wallet could not be debited |
| WALLET_BLOCKED | 336 | Your wallet has been blocked, withdrawals are not allowed |
| PUBLIC_KEY_INVALID | 337 | invalid public key, please check key or contact administrator |
| TRANSACTION_LIMIT_EXCEEDED | 338 | Amount exceeds transaction limit of {limit} |
| TRANSACTION_NOT_REVERSED | 339 | Transaction cannot be reversed |
| TRANSACTION_NOT_COMPLETED_REVERSED | 340 | Only successful transactions can be reversed |
| TOKEN_NOT_GENERATED | 341 | Token was not generated. Please try again later |