Error Codes Glossary

This section provides a list of common error codes returned by the DOKU API, along with their meanings and recommended actions.

Code	Meaning	Description
200	OK	Request was successful
201	Created	Resource was created successfully
400	Bad Request	Missing or invalid parameters
401	Unauthorized	Invalid or missing token
403	Forbidden	No permission to access this resource
404	Not Found	Resource does not exist
409	Conflict	Duplicate or invalid operation
422	Unprocessable Entity	Field validation failed
429	Too Many Requests	Rate limit exceeded
500	Internal Server Error	Server-side failure
503	Service Unavailable	Temporary server issue

Error Code	HTTP Status	Message Example	Description	Suggested Action
INVALID_PARAMETER	400	"amount is required"	Required field is missing or invalid	Check and correct the request body
INVALID_TOKEN	401	"Access token is invalid"	Token is expired or incorrect	Generate and use a new token
MERCHANT_NOT_ACTIVE	403	"Merchant account is inactive"	Account is not yet activated	Complete activation via Dashboard
TRANSACTION_NOT_FOUND	404	"Transaction ID not found"	The transaction doesn’t exist	Verify the transaction ID
DUPLICATE_TRANSACTION	409	"Transaction already processed"	Duplicate transaction reference	Use a unique transaction ID
VALIDATION_ERROR	422	"Email format is invalid"	Field format validation failed	Correct the input field format
TOO_MANY_REQUESTS	429	"Rate limit exceeded"	Too many requests in short time	Wait and retry after a delay
SERVER_ERROR	500	"Internal server error"	Unspecified server-side error	Retry or contact DOKU support
MAINTENANCE_MODE	503	"Service temporarily unavailable"	System is under maintenance	Retry later or check status page

JSON
{
  "status": "FAILED",
  "response_code": "INVALID_PARAMETER",
  "response_message": "amount is required"
}