Error Codes
This section provides detailed information about the error codes you may encounter while using the VirtualPay API. Understanding these codes will help you troubleshoot issues and ensure smooth integration.
Common Error Codes
Authentication Errors
1001: Invalid API Key
- Description: The API key provided is not valid.
- Resolution: Ensure you are using a valid API key. Generate a new key if necessary.
1002: Missing API Key
- Description: No API key was provided in the request.
- Resolution: Include your API key in the request headers.
Request Errors
2001: Invalid Request Parameters
- Description: One or more request parameters are invalid or missing.
- Resolution: Verify the parameters in your request. Refer to the API documentation for required parameters.
2002: Unsupported Request Method
- Description: The request method used is not supported for the endpoint.
- Resolution: Check the API documentation for the correct request method.
Transaction Errors
3001: Insufficient Funds
- Description: The account does not have enough funds to complete the transaction.
- Resolution: Ensure the account has sufficient funds before retrying the transaction.
3002: Transaction Limit Exceeded
- Description: The transaction amount exceeds the allowed limit.
- Resolution: Verify the transaction limits and adjust the amount accordingly.
Account Errors
4001: Account Not Found
- Description: The specified account does not exist.
- Resolution: Verify the account details and ensure the account exists.
4002: Account Blocked
- Description: The account is blocked and cannot be used for transactions.
- Resolution: Contact support to resolve the account block issue.
Full List of Error Codes
| Error Code | Description | Resolution |
|---|---|---|
| 1001 | Invalid API Key | Use a valid API key |
| 1002 | Missing API Key | Include your API key in the request headers |
| 2001 | Invalid Request Parameters | Verify request parameters |
| 2002 | Unsupported Request Method | Check API documentation for correct method |
| 3001 | Insufficient Funds | Ensure account has sufficient funds |
| 3002 | Transaction Limit Exceeded | Adjust transaction amount |
| 4001 | Account Not Found | Verify account details |
| 4002 | Account Blocked | Contact support |
