Product Statuses
Integration Guides API v2
Product statuses represent the outcome of each product within a workflow. Use the individual product statuses to determine the outcome of each verification or check. Use the workflow status to determine whether processing is in progress, has completed, or has failed.
Note
A product status of
completedindicates only that the product finished processing successfully. It does not indicate that the verification outcome is positive or that the client should be approved. Always evaluate the product status, messages, risk results, and report data before making onboarding or payment decisions.
Where to find product statuses
Product statuses are available through the workflow status API, webhook events, and JSON reports. The JSON property depends on the endpoint.
| Use case | API | JSON path | Property |
|---|---|---|---|
| Monitor workflow progress | Get workflow status | products[].status | status |
| Process webhook events | v2 webhook payload | details.status | status |
| Read final workflow results | Get report as JSON | products[].productStatus | productStatus |
Status codes
Status codes provide additional information about a product's processing state, including validation errors, inconsistent data, and verification failures.
Depending on the integration, status codes may be returned in:
products[].messagesin the workflow status responsedetails.messagesin webhook events- JSON reports, when messages are included
Status code categories
| Code or range | Category | Associated product statuses |
|---|---|---|
1000 | Validation successful | pending |
1001-1999 | Validation errors | invalid_data |
2000 series | Address consistency | inconsistent_data |
3000 series | Recoverable sendbacks | inconsistent_data |
4000 series | Rejection | completed |
5000 series | Fraud | completed |
6000-6015 | Qualified Electronic Signature (Signatures) | error, pending, user_consent_required, confirmation_required |
6050-6052 | eID verification | inconsistent_data |
7000 series | Bank Account Verification (Payments) | failed |
For detailed descriptions, and required actions, see the product-specific status documentation.
Product-specific statuses
The following sections describe the available product status values and associated status codes.
Identity Verification Statuses
Statuses and status codes for Identity Verification, including
sendbacks, rejections, fraud codes, and eID verification errors.
Qualified Electronic Signature Statuses
Statuses and status codes for Qualified Electronic Signature,
including signature flow errors and actions.
Bank Account Verification Statuses
Statuses and status codes for Bank Account Verification,
including transfer, verification progress, and failure codes.
Updated 8 days ago