---
title: Error Handling
slug: public-apis/error-handling
createdAt: 2026-03-09T13:48:41.900Z
---

::::ExpandableHeading
###

**Topic type: Constraint**

:::hint{type="warning"}
**Purpose**: Explain how Accertify APIs report and enforce request‑level errors.

**Audience**: API integrators and client developers.&#x20;

**Applies to**: Accertify APIs that return structured error responses.&#x20;

**Does not apply to**: Internal batch processing or non‑request‑based integrations.
:::
::::

Error responses indicate that an Accertify API request could not be processed as submitted. Errors are distinct from fraud decisions and do not reflect risk outcomes.

Errors are returned immediately and prevent the request from entering fraud evaluation or downstream processing.

Understanding error semantics is critical for building resilient integrations.

:::hint{type="info"}
<font color="#386B84">**Note**</font>: Universal Fraud APIs return validation and processing errors separately from fraud evaluation results. A validation failure indicates the request could not be processed, not that risk was detected
:::

:::ExpandableHeading{isOpen="true"}
## Error Categories

Errors may occur due to:

- Missing or invalid Required fields
- Failed Conditional dependencies
- Authentication or hashing failures
- Structural or formatting issues
- Unsupported or inconsistent values

Each error category represents a violation of platform constraints rather than an evaluation result.
:::

:::ExpandableHeading{isOpen="true"}
## Handling Errors Correctly

When an error is returned:

- The request should be reviewed and corrected
- The same invalid request should not be repeatedly retried
- Errors should be treated as integration or data quality issues

Retry logic should only be applied after correcting the underlying cause.
:::

:::ExpandableHeading{isOpen="true"}
## Logging and Monitoring Expectations

Clients should log error responses and monitor error rates over time. Persistent errors may indicate:

- Integration drift
- Schema mismatches
- Credential or authentication issues

Monitoring error patterns helps ensure continued alignment with platform constraints.
:::

