Errors handling

Here are all the basic errors you can receive while calling Mipise Payment Services API.

400 – Bad Request

Description: The request is invalid or malformed.

Common Causes:

• Missing required parameters
• Incorrect data formats
• Invalid UUIDs (e.g. platformUUID)

No Response sent:

JSON

---

401 – Unauthorized

Description: Authentication failed. The request lacks valid credentials.

Common Causes:

• Missing or expired JWT token
• Invalid authentication headers

Example Response:

JSON

{
  "error": "invalid JWT format or claim in Authorization header"
}

---

404 – Not Found

Description: The requested resource does not exist.

Common Causes:

• Non-existent platformUUID or other UUID in path.
• Attempting to access a deleted/nonexistent object/page.

Example Response:

JSON

{
  "code": 404,
  "title": "Resource not found",
  "message": "Sorry, we couldn't find the resource you're looking for."
}

---

422 – Unprocessable Content

Description: The request is syntactically correct but contains inconsistent or invalid data.

Common Causes:

• The request contains invalid or inconsistent data
• Required fields are missing or incorrectly formatted
• Actions are performed in the wrong sequence

Example Response:

JSON

{
  "errors": [
    "amount must be greater than zero, currency is not in range or set: [\"EUR\"]"
  ]
}

---

500 – Internal Server Error

Description: An unexpected server-side error occurred.

Common Causes:

• API server malfunction
• Temporary service outage

Advice: Retry the request now. If same problem occur, you might need to change something in the way you use the endpoint. If nothing can be changed, you can try later, log the full response for debugging, ask the support.

Example Response:

JSON

{
  "code": 500,
  "title": "Unexpected Error",
  "message": "Sorry, we couldn't process your request because of an unexpected error."
}

---

⚠️

Note: The exact response format may vary slightly depending on the endpoint.

Summary Table

HTTP Code	Meaning	Common Causes
400	Bad Request	Missing or invalid parameters
401	Unauthorized	Invalid or missing token
404	Not Found	Resource does not exist
422	Unprocessable Content	Invalid data or workflow inconsistency
500	Internal Server Error	Server-side problem