Skip to content

internal_server_error

Property Value
Error Code internal_server_error
HTTP Status 500 Internal Server Error
Title Internal server error

Description

An unexpected error occurred while processing the request. This indicates a server-side issue that is not caused by the request payload.

Example Response

{
  "type": "https://docs.payalo.com/errors/internal_server_error",
  "title": "Internal server error",
  "status": 500,
  "detail": "An unexpected error occurred while processing the request.",
  "errorCode": "internal_server_error"
}

Resolution

  • This error is retryable. Wait briefly and retry with exponential backoff.
  • Reuse the same merchantReference when retrying to ensure idempotency.
  • If the error persists after multiple retries, contact support.

Retry Strategy

Attempt 1: wait ~1 second
Attempt 2: wait ~2 seconds
Attempt 3: wait ~4 seconds
Attempt 4: wait ~8 seconds (max)

Add random jitter to avoid thundering herd effects. See Error Handling & Resilience for detailed retry guidance.