Hem UppdragHitta frilansuppdrag FaktureraSå fungerar fakturering UtbetalaAdministrera uppdragstagare SupportKundservice och hjälp
Land
Språk
Skapa ett gratis konto

API/Onboarding

Flöden

Onboarding

Innan ni kan skicka en utbetalning måste uppdragstagaren gå igenom fem steg. Fältet onboarding på användaren visar hela tiden vad som återstår.

Innehåll
Kom i gång
Flöden
Referens

Alla användarpayloads innehåller objektet onboarding (version v2). Där hittar du is_onboarded, en lista över missing_steps, och en detaljerad steps-översikt. Använd detta som facit i stället för att hålla eget tillstånd i ert system.

De fem stegen

StegEndpointSå här slutförs det
email_verifiedPOST /usersSätts automatiskt när användaren skapas eller kopplas via API:et.
terms_approvedPOST /users/{id}/termsSkicka {"approved": true} när uppdragstagaren har accepterat gällande villkor.
profilePUT /users/{id}/profileNamn, adress, postnummer, ort, landskod, telefon och main_work – alla obligatoriska.
bank_accountPUT /users/{id}Antingen norskt kontonummer, eller IBAN och BIC tillsammans. Aldrig båda i samma anrop.
id_verificationPOST /users/{id}/verification/flowsVeriff eller BankID. Se Verifiering.
Obs

Steget id_verification blir true först när entitetsverifieringen är godkänd och identitetsfälten från Veriff eller BankID är kompletta. En godkänd session utan personnummer ger fortfarande false.

Onboarding-objektet

Utdrag från 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"
  }
}

Rekommenderad ordning

  1. Registrera och få return-URL:en godkänd

    POST /verification-return-urls. Godkännandet är manuell och kan ta tid, så gör detta först – inte när ni redan har en uppdragstagare som väntar. Att API:et svarar 201 betyder inte att URL:en är godkänd ännu.

  2. Skapa eller koppla användaren

    POST /users med e-post, och gärna internal_id så att ni kan matcha mot ert eget system. Finns e-postadressen sedan tidigare kopplas den befintliga användaren till ert partnerkonto.

  3. Godkänn villkoren

    Hämta gällande villkor med GET /terms, visa dem för uppdragstagaren och registrera svaret med POST /users/{id}/terms.

  4. Registrera profil och bankkonto

    PUT /users/{id}/profile för hela profilen, och PUT /users/{id} för bankuppgifterna. Bankfälten följer en antingen–eller-regel: norskt kontonummer ensamt, eller IBAN och BIC tillsammans.

  5. Kör ID-verifiering

    POST /users/{id}/verification/flows, skicka användaren till verification_url, och polla GET /verification/status/{verificationSession} var 2:e–5:e sekund tills statusen är terminal.

  6. Bekräfta att användaren är färdigonboardad

    Hämta GET /users/{id} och kontrollera att onboarding.is_onboarded är true och att missing_steps är tom. Då kan ni skicka utbetalningar.

Bankuppgifter

Servern validerar att ni använder exakt en av varianterna. Blandar ni dem i samma begäran avvisas den.

VariantFältAnmärkning
Norskt kontobank_account_numberSkickas ensamt. Kombinera inte med IBAN eller BIC.
Internationellbank_iban_number + bank_bic_numberMåste skickas tillsammans. Om ni byter variant kan kolumnerna för den andra tömmas.

Fält som inte styr onboarding

POST /users godtar en del extra fält – first_name, last_name, adress, phone, main_work, note – för bakåtkompatibilitet med äldre integrationer. De slutför inte profilsteget. Använd PUT /users/{id}/profile för det.