Providers and connectors
Overview
Section titled “Overview”The Guardline Suite integrates with external providers at two points in the architecture:
- Onboarding Platform (ONP): verification providers invoked during onboarding journeys.
- Guardline Core: external sanctions and PEP lists queried by the whole suite.
Verification providers (ONP)
Section titled “Verification providers (ONP)”The ONP uses verification providers to validate customers’ identity and documents during onboarding. Providers are organized by verification category:
| Category | Function |
|---|---|
| Facial biometrics | Biometric capture and comparison |
| Document verification | Validation of document authenticity |
| Liveness | Liveness detection |
| Facematch | Comparison between selfie and document |
| Device fingerprint | Device identification and reputation |
| Background check | Registration, restrictive list and court record lookups |
| OCR | Data extraction and validity verification |
The most widely used providers in each category are already pre-integrated into the platform. The institution does not need to engage or configure these providers individually; Guardline manages the technical relationship.
Connector architecture
Section titled “Connector architecture”Each provider is integrated through a standardized connector. The connector architecture defines a uniform interface for all providers, regardless of their technical particularities. This means that replacing or adding a provider does not require changes to the institution’s integration with the ONP.
A connector encapsulates:
- Input: customer data and verification context that the provider needs to receive.
- Output: verification result with score and details returned by the provider.
- Callbacks: mechanism for receiving asynchronous responses from providers that do not respond instantly.
- Configuration: provider-specific credentials and parameters.
The institution can request the creation of connectors for providers that are not yet integrated. The process of integrating a new provider is conducted by the Guardline team.
Fallback mechanism
Section titled “Fallback mechanism”When a verification fails or the provider is unavailable, the platform applies a fallback mechanism with three levels:
- Automatic retry: the request is resent to the same provider after a configurable interval.
- Alternative provider: if the retry fails, the verification is redirected to an equivalent provider pre-configured in the same category.
- Conditional approval: if no provider responds, the onboarding can be referred to the analysis desk with conditional status, preventing the flow from being blocked by third-party unavailability.
This mechanism ensures that the institution’s operation does not depend on the availability of a single provider.
External lists (Core)
Section titled “External lists (Core)”The Guardline Core queries external sanctions and PEP lists as part of compliance checks. These lists are updated in real time and used by the whole suite (ONP, FPP, CMP).
| Source | Type |
|---|---|
| OFAC | International sanctions |
| UN | International sanctions |
| European Union | International sanctions |
| PEP | Politically Exposed Persons |
| BACEN | National regulatory lists |
In addition to public sources, the institution can import and maintain its own lists on the platform (internal lists, partner lists, sector lists).
Version 18, updated on