---
title: "Create a Multi-application card"
method: POST
path: "/v1/MULTI_APPLICATION_CARD/customer/{customerId}"
tags: ["Create card"]
---

# Create a Multi-application card

`POST /v1/MULTI_APPLICATION_CARD/customer/{customerId}`

This operation will create a credit or prepaid card media connected to given customer. An account id needs to be provided as well so we know to which account the card should be connected to.

## Path parameters

- `customerId` string, biginteger, required

## Query parameters

- `auditUser` string, required

## Request body

- CreateMultiApplicationCardResourceBody
  - `mainApplication` CreateApplication, required
    - `applicationName` string, required — Name of the application displayed on the POS terminal in text
    - `enabled` boolean, required — Allows to define if an application (PAN) is active on the chip. Only active applications are displayed
    - `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
    - `printed` boolean — To indicate if this PAN is printed on the physical card
    - `contactPriorityLevel` integer, required — Priority level of the application (PAN) on a POS terminal (Lowest is the first application listed)
    - `contactlessPriorityLevel` integer, required — Priority level of the contactless application (PAN) (not visible on terminal). Application with the lowest value will be used for contactless purchases
    - `digitalLayoutCode` string — Id used for digital wallet artwork and other related assets. Use of this need to be agreed with Enfuce separately
    - `accountId` string, required — The account id card is linked to
    - `productCode` string, required — This field is used when the institution has multiple card products setup. The productCode is used to determine the specific card product. Use of this field as well as the values of the field, is dependent on institution setup and should be aligned with Enfuce prior to use.
  - `applications` CreateApplicationWithEncryptedData[], required
    - `applicationName` string, required — Name of the application displayed on the POS terminal in text
    - `enabled` boolean, required — Allows to define if an application (PAN) is active on the chip. Only active applications are displayed
    - `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
    - `printed` boolean — To indicate if this PAN is printed on the physical card
    - `contactPriorityLevel` integer, required — Priority level of the application (PAN) on a POS terminal (Lowest is the first application listed)
    - `contactlessPriorityLevel` integer, required — Priority level of the contactless application (PAN) (not visible on terminal). Application with the lowest value will be used for contactless purchases
    - `digitalLayoutCode` string — Id used for digital wallet artwork and other related assets. Use of this need to be agreed with Enfuce separately
    - `accountId` string, required — The account id card is linked to
    - `productCode` string, required — This field is used when the institution has multiple card products setup. The productCode is used to determine the specific card product. Use of this field as well as the values of the field, is dependent on institution setup and should be aligned with Enfuce prior to use.
    - `encryptedData` string — JWE encrypted card number, see details above
  - `cardAddress` Address
    - `address1` string, required
    - `address2` string
    - `address3` string
    - `address4` string
    - `city` string, required
    - `country` string, required — A valid ISO 3166-1 alpha-3 country code, except for QZZ (UNMIK in Kosovo) and ROM for Romania.
    - `region` string
    - `zipCode` string, required
  - `embossing` Embossing — Default set of allowed characters for fields embossed onto the card: A-Z, a-z, Áá, Ää, Åå, Ææ, Éé, Íí, Ðð, Óó, Öö, Øø, Úú, Üü, Ýý, Þþ, 0-9, symbols -/.,&+' and space. For printed cards allowed characters are: (including the above) ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõöøùúûüý þÿĀāĂ㥹ĆćĈĉĊċČčĎďĐđĒēĔĕĖėĘęĚěĜĝĞğĠġĢģĤĥĦħĨĩĪīĬĭĮįİıIJijĴĵĶķĸĹ ĺĻļĽľĿŀŁłŃńŅņŇňʼnŊŋŌōŎŏŐőŒœŔŕŖŗŘřŚśŜŝŞşŠšŢţŤťŦŧŨũŪūŬŭŮůŰűŲųŴŵ ŶŷŸŹźŻżŽžſǪǫȘșȚțȪȫȮȯȲȳḐḑṢṣẞỌọ Printed or others characters sets must be agreed in advance.
    - `additionalField1` string — Field value is forwarded to embossing house in order to be used as additional embossing lines. In order to use this field selected embossing house must in advance agree where this is put.
    - `additionalField2` string — Field value is forwarded to embossing house in order to be used as additional embossing lines. In order to use this field selected embossing house must in advance agree where this is put.
    - `additionalField3` string — Field value is forwarded to embossing house in order to be used as additional embossing lines. In order to use this field selected embossing house must in advance agree where this is put.
    - `additionalField4` string — Field value is forwarded to embossing house in order to be used as additional embossing lines. In order to use this field selected embossing house must in advance agree where this is put.
    - `additionalField5` string — Field value is forwarded to embossing house in order to be used as additional embossing lines. In order to use this field selected embossing house must in advance agree where this is put.
    - `companyName` string
    - `externalLayoutCode` string — Code forwarded to embossing house in order to select which plastic layout to use. In order to use this field selected embossing house must in advance agree on name for each layout.
    - `firstName` string — The length of firstName should not exceed 26 characters length. A combined length of firstName and lastName should not exceed 26 characters length.
    - `lastName` string — The length of lastName should not exceed 26 characters length. A combined length of firstName and lastName should not exceed 26 characters length.
    - `additionalEmbossingName` string — Optional additional embossing name to be printed on the card as a second line, alongside the primary embossing name. Usage of this field and its placement on the card must be agreed with the relevant card bureau.
    - `manufacturer` string — Name of manufacturer for the card. This has to be agreed in advance with Enfuce in order to support multiple embossing houses.
    - `physical` boolean — This tag will indicate will there be a physical representation of the card. If true, the card will be placed for card personalisation and end user will receive a physical plastic. If false, the card will not be placed for card personalisation and end user will not receive a physical plastic.
  - `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
  - `pinAddress` Address
    - `address1` string, required
    - `address2` string
    - `address3` string
    - `address4` string
    - `city` string, required
    - `country` string, required — A valid ISO 3166-1 alpha-3 country code, except for QZZ (UNMIK in Kosovo) and ROM for Romania.
    - `region` string
    - `zipCode` string, required
  - `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

## Response `201`

Successful creation of the product

- MultipleResourceResponse
  - `description` string — Short description of the result of the action
  - `mainId` string, required — Will contain the ID of the resource that has been created or updated
  - `applications` object[], required — Will contain the IDs of the resources that have been created or updated
    - `id` string, required
    - `accountId` string, required

## 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/revisions/dc4a41118f80/schema)