Skip to content

The createAccount journey guides the end-customer through opening a new investment account: BankID identity verification, PEP/sanctions screening, KYC questionnaire, account type selection, and agreement signing.

Create the journey via POST /v2/partner/client/:clientId/journey with journeyType: "createAccount".

Required fields

accountTypes controls which account types the customer can open (isk, depot, insurance). accountServiceType sets the investment service level (portfolioManagement, investmentAdvise, executionOnly).

Optional configuration

Account name

Provide accountName to fix the account name without showing it to the customer. If omitted, the customer enters one.

Email

Provide email to prefill the customer's email address.

Allocation plan

Set allocationPlan to configure a fund allocation during account creation. The customer confirms the allocation in the journey. Set to null to skip this step. allocationPlan and savingsPlan cannot both be set.

Savings plan

Set savingsPlan to let the customer configure a recurring savings plan during account creation. Set to null to skip.

Transfer

Set transfer to include a 3rd-party holdings transfer step — moving assets from another institution into the new account. See Transfer Configuration for details and examples.

Set welcomeScreen: "transfer" to show a transfer-themed welcome screen. Only valid when transfer is also set.

Schema

journeyTypestring(createAccount)required
Value"createAccount"
welcomeScreenstring

Optional custom welcome screen. Currently only available when transfer is set.

  • transfer — only allowed in combination with populated transfer field
Value"transfer"
emailstring or null(email)

end user email address

Example: "enduser@endUserDomain.com"
accountNamestring<= 500 characters

If not provided, the end-user will be asked to select accountName. If provided, the accountName will not be visible to the customer in this journey.

accountTypesArray of anyrequired

Allowed account types

Items Enum"isk""depot""insurance"
accountServiceTypestring(accountServiceType)required

Account service type

Enum"portfolioManagement""investmentAdvise""executionOnly"
accountCategoriesArray of strings(Optional Account Categories)

MiFID II investor classification. If the client permissions allows both pro and retail customers, this must be set. It must never exceed the permissions on the client.

  • pro — Professional investor (MiFID II)
  • retail — Retail investor, protected by consumer protection regulations (MiFID II)
Items Enum"pro""retail"
allocationPlanobject or null

Setup an allocation plan for the account. Deposits will allocate based on this plan. If null the view will not be shown

savingsPlanobject or null

Enable savings plan setup during account creation. User will configure instruments and amounts in the UI. If null the view will not be shown.

kycsArray of objects or null

Valid Know Your Customer answers used to prefill the options in the journey.

transferobject or null(Transfer)

Transfer configuration from 3rd party institution into newly created Fondo Account. If defined, the transfer screen is shown. If null the transfer view will not be shown.