Skip to main content

​
Registrere return URL

Før du kan starte en verifisering må du registrere en gyldig return URL: 
POST /verification-return-urls
Denne må godkjennes av EasyFreelance, og så fort den er godkjent, kan du benytte API-et. Responsen inneholder:
  • requested_url – den registrerte base-URLen (brukes til matching)
  • status – godkjenningsstatus
  • normalized_host
  • normalized_scheme
  • normalized_path_prefix
Viktig:
  • Matching av return URL skjer basert på requested_url
  • normalized_*-feltene brukes kun til:
    • visning
    • allowlisting
    • database-validering
  • normalized_path_prefix er ikke en path-template og skal ikke brukes til matching-logikk

​
Start verifiseringssesjon

Når return URL er godkjent, kan du starte en verifiseringsflyt: 
POST /users/{id}/verification/flows
Payload inkluderer:
  • provider (f.eks. Veriff, BankID)
  • partner_return_url
Krav:
  • partner_return_url må være:
    • godkjent
    • matche en registrert requested_url

​
Motta respons

Responsen fra opprettelsen inneholder:
  • verification_id → brukes til å følge status (polling)
  • verification_url → URL som skal åpnes i sluttbrukerens nettleser

​
Brukerflyt

Flyten for sluttbrukeren er:
  1. Brukeren åpner verification_url
  2. Fullfører verifisering hos:
    • EasyFreelance (hostede sider)
    • videre til Veriff eller BankID
  3. Returnerer til EasyFreelance
  4. Blir redirectet til partner_return_url

​
Hent status

Backend må følge opp verifiseringen: 
GET /verification/status/{verificationSession}
Bruk verification_id fra steg 3. Anbefaling:
  • Poll til status er terminal (f.eks. approved / rejected)
  • Alternativt:
    • bruk webhooks dersom tilgjengelig (ikke definert i OpenAPI)

​
Relaterte modeller

Detaljer om felter og struktur finnes under:
  • VerificationFlow
  • VerificationReturnUrlRequest