Klientų onboarding API v3

Greitas, saugus ir teisėtai atitinkantis Lietuvos reikalavimus klientų registracijos ir KYC procesas per REST API.

  • PSD2 ir GDPR compliant
  • Parengta integracijai su Luminor sistemos back-end
  • Webhooks, idempotency, saugumo antraštės
Onboarding

Apžvalga

Kiekvienas žingsnis automatizuotas: vartotojo duomenų pateikimas, dokumentų įkėlimas, tapatybės patikra, rizikos patikrinimas. Minimalus laikotarpis iki patvirtinimo — priklauso nuo dokumentų kokybės.

99.9%
Sistemos prieinamumas
Saugus ryšys (TLS)
Architecture

Techniniai reikalavimai

Žemiau pateikta santrauka: autentifikacija, limitai, content-type. Pilna specifikacija — pagal susitarimą su Luminor.

Elemento pavadinimasReikšmėPastaba
AutentifikacijaOAuth2 Client Credentials / Mutual TLSRekomenduojamas mTLS produkcijoje
Rate limit100 req/minAdaptuojama pagal SLA
Formataiapplication/jsonBase64 dokumentams
IdempotencyX-Idempotency-Key30 dienų

Pagrindiniai endpoint'ai

Payload: customer basic info, locale, callback_url. Response: onboarding_id, next_steps. HTTP 201.

Įkelkite dokumentus Base64. Patikrinkite dokumentų tipą (passport, id_card, utility_bill).

Grąžina dabartinį būsenos kodą, rizikos rezultatus ir rekomenduojamus veiksmus.

Integracijos žingsniai

  1. Gaukite testinę prieigą (sandbox credentials).
  2. Įdiekite autentifikaciją (OAuth2 / mTLS).
  3. Siųskite testinius onboarding request'us ir stebėkite webhook'us.
  4. Pereikite patvirtinimo ir gaunate produkcinę prieigą.

Visus žingsnius koordinuos Luminor techninė komanda.

Integration
Team lead

Techninis kontaktas

Simonas Petrauskas — API integracijos vadovas. Koordinuoja sandbox prieigą ir techninę paramą.

DUK

Ar API palaiko asmenų tapatybės nuotraukas?

Taip — priimame Base64 užkoduotas nuotraukas su nurodytu metaduomenų tipu.

Kiek laiko galioja sandbox kredencialai?

Standartiškai 90 dienų. Susisiekite per Contacts, jei reikia pratęsti.

Integracijos pavyzdys (cURL)
curl -X POST "https://api.luminor.lt/v3/onboarding/start" \ -H "Authorization: Bearer {token}" \ -H "Content-Type: application/json" \ -d '{"firstName":"Jonas","lastName":"Jonaitis","locale":"lt","callback_url":"https://merchant.example/cb"}'