Sign in
Savings Accounts

Update a person's account mapping association.

Modifies the existing mapping configuration for a person’s savings account. This endpoint allows for the transition of the main account association or the adjustment of interest rate tiers. Note: Use this endpoint only for accounts that have already been initially mapped via the POST method.

patch/v1/persons/{person_id}/deposit_accounts/{account_id}/mappings

Path parameters

person_idstring required

Unique ID of a person.

account_idstring required

Unique ID of a Solaris account.

Request body

main_account_ibanstring

IBAN of the external main account.

deposit_type'SAVINGS_ACCOUNT' required

The account type.

interest_tier'INTEREST_BASE_TIER' | 'INTEREST_TIER_1' | 'INTEREST_TIER_2' | 'INTEREST_TIER_3' | 'INTEREST_TIER_4' | 'INTEREST_TIER_5'

Tier to which the savings account belongs. Note: If you've configured multiple standard interest rates (tiered interest rates), send the interest tier value in this field. If no value is sent, the system will default to the base tier.

Example request

{
  "main_account_iban": "DE17110101000000000042"
}

Response

The mapping update was successful.

idstring required

ID of the mapping between the main account and the savings account.

main_account_ibanstring required

IBAN of the external main account.

status'OPENED' | 'TAX_REGISTERED' | 'ACTIVE' | 'INACTIVE' | 'FAILED' required

The current status of the savings account.

deposit_type'SAVINGS_ACCOUNT' required

The account type.

interest_tier'INTEREST_BASE_TIER' | 'INTEREST_TIER_1' | 'INTEREST_TIER_2' | 'INTEREST_TIER_3' | 'INTEREST_TIER_4' | 'INTEREST_TIER_5'

Tier to which the savings account belongs. Note: If you've configured multiple standard interest rates (tiered interest rates), send the interest tier value in this field. If no value is sent, the system will default to the base tier.

Example response

{
  "id": "d222a0b8-07ea-49be-83c1-68719be286e8",
  "main_account_iban": "DE17110101000000000042"
}