Driver Registration & KYC API for a Mobility Platform

Overview

The registration and identity-verification backend for a car-sharing / mobility platform. It orchestrates the full driver onboarding journey, account creation, ID and driver’s-license capture, background checks, payment setup and subscription, behind a single REST API.

The Challenge

Onboarding a driver for shared mobility is a compliance-heavy, multi-vendor process: verify a phone number, capture and process identity documents and a driver’s license, run a background/eligibility check, register a payment method, and create a subscription, each handled by a different external provider, and all of it must be coordinated reliably.

What We Built

An AdonisJS 4 API whose controllers map directly to the onboarding pipeline: authentication, configuration, ID and driver’s-license handling, document processing, SMS verification, background/eligibility checks, payment, subscription and data export. The service integrates multiple third-party providers, Adyen and Stripe for payments, Plivo for SMS one-time passwords, and a background-check provider for driver eligibility, plus Joi validation, country normalization (i18n-iso-countries, countrynames, remove-accents-diacritics), and image handling for uploaded identity documents (base64-img, jpeg-autorotate) stored under an identity_cards workspace. Email goes through AdonisJS Mail; persistence runs on Lucid ORM (MySQL/SQLite); logging uses Winston with syslog transport; CI runs on GitLab. Fleet/region behavior is driven by JSON configuration.

Technologies & Approach

AdonisJS provided a structured controller/service/model layout to keep a complex, many-vendor flow maintainable. Each external integration (payments, SMS, background checks, ID handling) was isolated into its own controller so the onboarding state machine stayed legible and individual providers could evolve independently.

Outcome / Impact

Delivered the compliance-critical onboarding core of the mobility product, reaching a tagged v3.6.0 release line. It proves the studio’s ability to build KYC-grade, multi-provider onboarding backends spanning identity, payments and background verification.

Capabilities Demonstrated

• KYC / identity-verification onboarding pipelines
• Payment integration with Adyen and Stripe
• SMS one-time-password verification (Plivo)
• Third-party background / eligibility check integration
• Identity-document image processing and storage
• Subscription and billing setup
• Structured AdonisJS REST API with GitLab CI