Hjem OppdragFinn frilansoppdrag FakturereSlik fungerer fakturering UtbetaleAdministrer oppdragstakere SupportKundeservice og hjelp
Land
Språk
Lag en gratis konto

API/Onboarding

Flyter

Onboarding

Før dere kan sende en utbetaling må oppdragstakeren gjennom fem steg. Feltet onboarding på brukeren forteller til enhver tid hva som gjenstår.

Innhold
Kom i gang
Flyter
Referanse

Alle brukerpayloads inneholder objektet onboarding (versjon v2). Der finner du is_onboarded, en liste over missing_steps, og en detaljert steps-oversikt. Bruk dette som fasit i stedet for å holde egen tilstand i deres system.

De fem stegene

StegEndepunktSlik fullføres det
email_verifiedPOST /usersSettes automatisk når brukeren opprettes eller kobles via API-et.
terms_approvedPOST /users/{id}/termsSend {"approved": true} når oppdragstakeren har akseptert gjeldende vilkår.
profilePUT /users/{id}/profileNavn, adresse, postnummer, sted, landkode, telefon og main_work – alle påkrevd.
bank_accountPUT /users/{id}Enten norsk kontonummer, eller IBAN og BIC sammen. Aldri begge deler i samme kall.
id_verificationPOST /users/{id}/verification/flowsVeriff eller BankID. Se Verifisering.
Merk

Steget id_verification blir true først når entitetsverifiseringen er godkjent og identitetsfeltene fra Veriff eller BankID er komplette. En godkjent sesjon uten fødselsnummer gir fortsatt false.

Onboarding-objektet

Utdrag fra GET /users/{id}
{
  "onboarding": {
    "is_onboarded": false,
    "missing_steps": [
      "id_verification"
    ],
    "steps": {
      "email_verified": true,
      "terms_approved": true,
      "profile": true,
      "id_verification": false,
      "bank_account": true
    },
    "status_version": "v2",
    "evaluated_at": "2026-07-08T12:00:05+00:00"
  }
}

Anbefalt rekkefølge

  1. Registrer og få godkjent return-URLen

    POST /verification-return-urls. Godkjenningen er manuell og kan ta tid, så gjør dette først – ikke når dere allerede har en oppdragstaker som venter. At API-et svarer 201 betyr ikke at URLen er godkjent ennå.

  2. Opprett eller koble brukeren

    POST /users med e-post, og gjerne internal_id så dere kan matche mot deres eget system. Finnes e-posten fra før, kobles den eksisterende brukeren til partnerkontoen deres.

  3. Godkjenn vilkårene

    Hent gjeldende vilkår med GET /terms, vis dem for oppdragstakeren, og registrer svaret med POST /users/{id}/terms.

  4. Registrer profil og bankkonto

    PUT /users/{id}/profile for hele profilen, og PUT /users/{id} for bankopplysningene. Bankfeltene følger en enten–eller-regel: norsk kontonummer alene, eller IBAN og BIC sammen.

  5. Kjør ID-verifisering

    POST /users/{id}/verification/flows, send brukeren til verification_url, og poll GET /verification/status/{verificationSession} hvert 2.–5. sekund til status er terminal.

  6. Bekreft at brukeren er ferdig onboardet

    Hent GET /users/{id} og sjekk at onboarding.is_onboarded er true og at missing_steps er tom. Da kan dere sende utbetalinger.

Bankopplysninger

Serveren validerer at dere bruker nøyaktig én av variantene. Blander dere dem i samme forespørsel, avvises den.

VariantFeltMerknad
Norsk kontobank_account_numberSendes alene. Ikke kombiner med IBAN eller BIC.
Internasjonalbank_iban_number + bank_bic_numberMå sendes sammen. Bytter dere variant, kan kolonnene for den andre bli tømt.

Felter som ikke driver onboarding

POST /users godtar en del ekstra felter – first_name, last_name, adresse, phone, main_work, note – for bakoverkompatibilitet med eldre integrasjoner. De fullfører ikke profilsteget. Bruk PUT /users/{id}/profile for det.