validation_failed¶
| Property | Value |
|---|---|
| Error Code | validation_failed |
| HTTP Status | 400 Bad Request |
| Title | Validation failed |
Description¶
A required field is missing, has an invalid format, or does not meet the expected constraints. This is the default validation error code when no more specific business error code applies.
Example Response¶
{
"type": "https://docs.payalo.com/errors/validation_failed",
"title": "Validation failed",
"status": 400,
"detail": "MerchantReference is required.",
"errorCode": "validation_failed"
}
Common Causes¶
| Cause | Example detail Message |
|---|---|
| Missing required field | "MerchantReference is required." |
| Invalid field format | "ResultUrl must be a valid URL." |
| Field exceeds max length | "MerchantReference must not exceed 255 characters." |
| Invalid email format | "Email must be a valid email address." |
| Invalid phone format or length | "Msisdn must be a valid MSISDN." (format), "Msisdn must be at least 3 characters." (too short), or "Msisdn must not exceed 20 characters." (too long) |
| Labels exceed limit | "Labels must not have more than 10 entries." |
Resolution¶
- Check the
detailfield for the specific validation message. - Ensure all required fields are present and correctly formatted.
- Refer to the endpoint documentation for field requirements and constraints.
Note: This error is not retryable. Fix the request before resubmitting.