Documentation

UValid Cloud Platform Guides

Everything you need to configure identities, onboard organisations, and integrate APIs with the UValid Cloud Platform. Choose your role below and follow the recommended workflows for a secure deployment.

Last updated: April 2025
Coverage: Admin Console • Enterprise Operations • REST / Webhook APIs

Platform Overview

UValid Cloud Platform provides unified access to Nigerian identity registries, business intelligence sources, and compliance screening tools. The platform is designed for regulated institutions that require verifiable data, auditable workflows, and timely risk insights across customer lifecycles.

  • Identity data sources: NIMC (NIN), NIBSS (BVN), Immigration (Passport), FRSC (Driver’s Licence)
  • Business data sources: CAC filings, FIRS/TIN, director and shareholder registries
  • Compliance insights: sanctions, PEP, adverse media, enforcement notices

UValid Admin & Analyst Manual

Getting Started

  1. Create or receive your UValid operator account from an organisation administrator.
  2. Sign in via /login using email, password, and Google Authenticator MFA.
  3. Select your assigned role (Admin or Agent) to access the corresponding dashboards.

Core Dashboards

  • Identity Validation: Submit NIN, BVN, Passport, or Driver’s Licence queries and review verification results, watchlist matches, and audit logs.
  • Business Intelligence: Retrieve CAC filings, active/inactive status, tax references, and beneficial ownership summaries.
  • Compliance Monitoring: Configure screening lists, schedule recurring checks, and export regulatory reports.

Operational Best Practices

  • Always confirm customer consent before querying national registries.
  • Use tagging and notes to maintain investigation context for follow-up teams.
  • Leverage downloads (CSV/PDF) for regulatory submissions and internal audit trails.

Enterprise Client Onboarding Guide

Account Provisioning

  • Submit organisation details, regulatory licence, and authorised signatories to UValid onboarding.
  • Define access policies (Admin, Analyst, API user) and MFA requirements for your team.
  • Complete the data protection addendum and agree to acceptable use terms.

Environment Configuration

  • Staging sandbox: Issued for integration testing, populated with masked datasets.
  • Production: Enabled after compliance review, with traffic throttles aligned to contracted volumes.
  • IP allow-listing: Provide corporate ranges or VPN egress addresses for additional security.

Governance & Reporting

  • Use the monthly activity report to reconcile usage and billing.
  • Enable real-time webhooks for fraud escalations and regulatory breach alerts.
  • Nominate a compliance contact for incident response and coordinated disclosures.

API Quick Start

Authentication

  • Generate API credentials from the API Users dashboard (Admin role required).
  • Tokens are JWTs signed with RS256 and scoped to specific services (e.g., identity:nin).
  • Include the token in requests: Authorization: Bearer <token>.

Sample Request

POST https://api.uvalid.com/client/v1/identity/nin
Authorization: Bearer <token>
Content-Type: application/json

{
  "nin": "12345678901",
  "channel": "digital-onboarding",
  "reference": "APP-2025-00045"
}

Handling Responses

  • 200 OK: Verification result with matched registries and confidence scores.
  • 202 Accepted: Long-running checks (e.g., deep compliance screening) – poll status endpoint.
  • 4xx: Validation errors, missing scope, or inactive account.
  • 5xx: Platform unavailable – retry with exponential backoff.

Refer to the full OpenAPI specification for field-level documentation and webhook schemas. The latest spec is available in JSON and YAML formats via the developer portal.

Security & Compliance

  • All data in transit is TLS 1.2+ encrypted; data at rest uses AES-256 with key rotation.
  • MFA is enforced for every operator and API credential rotation is scheduled every 90 days.
  • Audit trails capture who accessed what data, with exports available for regulatory reviews.
  • UValid undergoes annual penetration testing and PCI DSS attestation for payment-related integrations.

Support & Escalation

  • Knowledge base and FAQs are accessible within the platform sidebar.
  • Priority incidents: Email support@uvalid.com with SLA severity.
  • 24/7 hotline: +234 700 225 522.
  • Developers: Join the developer workspace for release notes and changelog RSS feeds.