---
title: "Create a multi-currency account"
method: POST
path: "/v4/{multiCurr}/customer/{customerId}"
tags: ["Create an account"]
---

# Create a multi-currency account

`POST /v4/{multiCurr}/customer/{customerId}`

This operation will create a multicurrency account

## Path parameters

- `multiCurr` 'MULTICURR_DKK_DK' | 'MULTICURR_EUR_AT' | 'MULTICURR_EUR_DE' | 'MULTICURR_EUR_ES' | 'MULTICURR_EUR_FI' | 'MULTICURR_EUR_FR' | 'MULTICURR_EUR_IE' | 'MULTICURR_EUR_IT' | 'MULTICURR_GBP_GB' | 'MULTICURR_SEK_SE' | 'MULTICURR_EUR_NL' | 'MULTICURR_EUR_LU' | 'MULTICURR_EUR_BE' | 'MULTICURR_NOK_NO' | 'MULTICURR_EUR_PT' | 'MULTICURR_EUR_EE' | 'MULTICURR_EUR_LV' | 'MULTICURR_EUR_LT' | 'MULTICURR_EUR_MT' | 'MULTICURR_PLN_PL', required
- `customerId` string, biginteger, required

## Query parameters

- `auditUser` string, required

## Request body

- CreateMultiCurrencyResourceBody
  - `expiration` Expiration
    - `year` integer — Expiration year in format YYYY
    - `month` integer — Expiration month in format MM
  - `segment` 'SEGMENT_A' | 'SEGMENT_B' | 'SEGMENT_C' | 'SEGMENT_D' | 'SEGMENT_E' | 'SEGMENT_F' — Field enables to group an entity into a segment. This field will be exported but no logic is applied to this in Enfuce API
  - `pinStatus` 'D' | 'W' | 'S' — This flag will indicate current status for PIN generation. If not specified system will automatically assign D as default and make sure a PIN is calculated during next embossing process. If set to W, then card will be excluded from embossing process until a PIN has been set and status has been updated to S. It is also possible to revert to D, in order for system to generate PIN. Note that system will update to status S automatically when a PIN is set successfully. ### New card In order for a new card to not get a system generated PIN then pinStatus flag must be set to W when created, this will then halt the embossing process for given card until a PIN has been set. ### Reissue card When reissuing a card it is possible to set pinStatus to W in order to hold embossing process for given card until a PIN has been set. Update pinStatus is done on same card id that is reissued. ### Replace card When replacing a card it is possible to set pinStatus to W in order to hold embossing process for given card until a PIN has been set. Update pinStatus is done on new card id that is returned when replacing. - D - default and a random PIN will be generated - W - waiting for PIN to be manually set - S - PIN has been set successfully
  - `digitalLayoutCode` string — Id used for digital wallet artwork and other related assets. Use of this need to be agreed with Enfuce separately
  - `scheduledClosing` ScheduledClosing — Scheduled closing of the card. Use of this object should be aligned with Enfuce prior to use.
    - `type` 'TIMEBASED' — This field is used when there is a need to setup the scheduled closing of the card. Use of this field should be aligned with Enfuce prior to use.
    - `time` string, date-time — This field is used to determine the date for closing of the card. Card will be closed on that date which is selected. The time specified in the closing time must adhere to the UTC time zone. Use of this field should be aligned with Enfuce prior to use.
  - `additionalValues` KeyValuePair[] — The additionalValues array is used to store information in the form of key-value pairs. Enfuce does not perform any validation on these key-value pairs beyond ensuring they adhere to the character limit constraints. The primary purpose of these key-value pairs is to store data without further processing. In newer versions of the card personalization files, these key-value pairs are included in the file. However, this inclusion is version-dependent. We recommend consulting the specific version details of your card personalization files to confirm whether these values will be added to the card personalization file in your case.
    - `key` string, required
    - `value` string, required
  - `encryptedData` string — JWE encrypted card number, see details above
  - `creditLimit` number — Credit limit of the account
  - `externalBalanceCheck` boolean — The external balance check parameter enables the issuer to determine per account, whether the available balance during authorisation process should be checked by Enfuce or issuer (utilising Authorisation Control service). When set to “true”, Enfuce will not check the available balance of the account rather the issuer is expected to do it. As the parameter is set on account level, it will automatically apply to all cards linked to account in question. Please note that utilisation of this parameter requires implementation of the Authorisation Control service.
  - `subAccountTemplates` SubAccountTemplatesEnum[] — Templates for sub accounts to be created. Check usage with Enfuce!

## Response `201`

Successful creation of the account

- ResourceResponse
  - `description` string — Short description of the result of the action
  - `id` string — Will contain the ID of the resource that has been created or updated

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Customer does not exist
- `500` — Internal server error

---

[API](https://skmtc.net/enfuce/apis/transfer-api.md) · [All operations](https://skmtc.net/enfuce/apis/transfer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/enfuce/transfer-api/versions/dc4a41118f80/schema)