Error Code – PlayerAuctions Help Center

API Error Codes Reference

This document provides a comprehensive list of all error codes returned by the PA Seller API, including their meanings and common causes.

i. Error Codes Overview

Error codes are returned in the code field of the API response. The error code format follows a 5-digit number pattern where the first digit indicates the category of the error:

1xxxx - Success and Parameter errors
2xxxx - Signature and Authentication errors
3xxxx - Authorization errors
4xxxx - Business logic errors
5xxxx - Internal server errors

ii. Complete Error Codes List

Error Code	Name	Category	Description
10000	Success	Success	Operation completed successfully.
10001	MissingHeader	Parameter	Required HTTP header is missing from the request.
10002	InvalidParameter	Parameter	One or more request parameters are invalid or malformed.
20001	InvalidSignature	Signature	The request signature verification failed.
30001	AuthenticationError	Authentication	Authentication failed. Invalid or missing credentials.
30002	AuthrizationError	Authorization	Authorization failed. User does not have permission to perform this action.
40001	BusinessError	Business	A business rule validation failed.
50001	InternalServerError	Server Error	An unexpected error occurred on the server.

iii. Error Response Format

Error Response Example

{
  "code": 10002,
  "message": "Invalid parameter",
  "requestId": "550e8400-e29b-41d4-a716-446655440000"
}

Error Response Parameters

Parameter	Type	Description
code	int	Error code indicating the type of error that occurred.
message	string	Detailed error message explaining what went wrong.
requestId	string	Unique identifier for the request, used for tracking and debugging.

iv. Detailed Error Code Descriptions

1xxxx - Success and Parameter Errors

Error Code	Description	Common Causes	Resolution
10000	Success	N/A	Operation completed successfully. No action needed.
10001	MissingHeader	Required HTTP headers (e.g., Authorization, X-Timestamp, X-Signature) are missing.	Ensure all required headers are included in the request.
10002	InvalidParameter	Parameter is missing, has wrong type, or contains invalid value.	Check request parameters against API documentation and correct any issues.

2xxxx - Signature Errors

Error Code	Description	Common Causes	Resolution
20001	InvalidSignature	Request signature does not match expected value due to incorrect secret key, timestamp mismatch, or malformed signature.	Verify your API secret key, ensure system time is synchronized, and check signature generation algorithm.

3xxxx - Authentication and Authorization Errors

Error Code	Description	Common Causes	Resolution
30001	AuthenticationError	Invalid API key, expired credentials, or incorrect authentication method.	Verify your API credentials are valid and not expired. Check authentication method.
30002	AuthrizationError	User lacks permission to access the requested resource or perform the action.	Ensure your account has the necessary permissions. Contact support if needed.

4xxxx - Business Logic Errors

Error Code	Description	Common Causes	Resolution
40001	BusinessError	Request violates business rules (e.g., insufficient balance, invalid offer status, duplicate operation).	Review the error message for specific business rule violation details and adjust your request accordingly.

5xxxx - Server Errors

Error Code	Description	Common Causes	Resolution
50001	InternalServerError	Unexpected server error, database connection issue, or service unavailability.	Retry the request after a short delay. If the error persists, contact support with the requestId.

Notes

Always include the requestId when reporting issues to support, as it helps trace the specific request that failed.
Error messages may contain additional details about the specific issue, so always review the message field carefully.