Partially Update Card

curl --request PATCH \
  --url 'https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/issuer/v1/cards/{id}' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chipEnabled": true,
  "digitalLayoutCode": 9,
  "applicationName": "Credit Application",
  "contactPriorityLevel": 1,
  "contactlessPriorityLevel": 1,
  "printed": true,
  "cardholderId": "20218aae-b15e-406c-9e9f-23735cd86a48",
  "accountId": "20218aae-b15e-406c-9e9f-23735cd86a48",
  "automaticRenewal": true,
  "plastic": {
    "embossingName": "John Doe",
    "preferredCardDeliveryType": "MAIL",
    "preferredPinDeliveryType": "MAIL",
    "manufacturerId": "20218aae-b15e-406c-9e9f-23735cd86a48",
    "externalLayoutCode": 1
  },
  "cardStatus": "ACTIVE",
  "impactTokenStatus": true,
  "pinStatus": "GENERATED",
  "additionalValues": {
    "keyWithPlainTextValue": "value1",
    "keyWithBase64Value": "dmFsdWUyYmFzZTY0ZW5jb2RlZA=="
  },
  "feeConfigId": "SILVER"
}
'

import requests

url = "https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/issuer/v1/cards/{id}"

payload = {
    "chipEnabled": True,
    "digitalLayoutCode": 9,
    "applicationName": "Credit Application",
    "contactPriorityLevel": 1,
    "contactlessPriorityLevel": 1,
    "printed": True,
    "cardholderId": "20218aae-b15e-406c-9e9f-23735cd86a48",
    "accountId": "20218aae-b15e-406c-9e9f-23735cd86a48",
    "automaticRenewal": True,
    "plastic": {
        "embossingName": "John Doe",
        "preferredCardDeliveryType": "MAIL",
        "preferredPinDeliveryType": "MAIL",
        "manufacturerId": "20218aae-b15e-406c-9e9f-23735cd86a48",
        "externalLayoutCode": 1
    },
    "cardStatus": "ACTIVE",
    "impactTokenStatus": True,
    "pinStatus": "GENERATED",
    "additionalValues": {
        "keyWithPlainTextValue": "value1",
        "keyWithBase64Value": "dmFsdWUyYmFzZTY0ZW5jb2RlZA=="
    },
    "feeConfigId": "SILVER"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    chipEnabled: true,
    digitalLayoutCode: 9,
    applicationName: 'Credit Application',
    contactPriorityLevel: 1,
    contactlessPriorityLevel: 1,
    printed: true,
    cardholderId: '20218aae-b15e-406c-9e9f-23735cd86a48',
    accountId: '20218aae-b15e-406c-9e9f-23735cd86a48',
    automaticRenewal: true,
    plastic: {
      embossingName: 'John Doe',
      preferredCardDeliveryType: 'MAIL',
      preferredPinDeliveryType: 'MAIL',
      manufacturerId: '20218aae-b15e-406c-9e9f-23735cd86a48',
      externalLayoutCode: 1
    },
    cardStatus: 'ACTIVE',
    impactTokenStatus: true,
    pinStatus: 'GENERATED',
    additionalValues: {
      keyWithPlainTextValue: 'value1',
      keyWithBase64Value: 'dmFsdWUyYmFzZTY0ZW5jb2RlZA=='
    },
    feeConfigId: 'SILVER'
  })
};

fetch('https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/issuer/v1/cards/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/issuer/v1/cards/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'chipEnabled' => true,
    'digitalLayoutCode' => 9,
    'applicationName' => 'Credit Application',
    'contactPriorityLevel' => 1,
    'contactlessPriorityLevel' => 1,
    'printed' => true,
    'cardholderId' => '20218aae-b15e-406c-9e9f-23735cd86a48',
    'accountId' => '20218aae-b15e-406c-9e9f-23735cd86a48',
    'automaticRenewal' => true,
    'plastic' => [
        'embossingName' => 'John Doe',
        'preferredCardDeliveryType' => 'MAIL',
        'preferredPinDeliveryType' => 'MAIL',
        'manufacturerId' => '20218aae-b15e-406c-9e9f-23735cd86a48',
        'externalLayoutCode' => 1
    ],
    'cardStatus' => 'ACTIVE',
    'impactTokenStatus' => true,
    'pinStatus' => 'GENERATED',
    'additionalValues' => [
        'keyWithPlainTextValue' => 'value1',
        'keyWithBase64Value' => 'dmFsdWUyYmFzZTY0ZW5jb2RlZA=='
    ],
    'feeConfigId' => 'SILVER'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/issuer/v1/cards/{id}"

	payload := strings.NewReader("{\n  \"chipEnabled\": true,\n  \"digitalLayoutCode\": 9,\n  \"applicationName\": \"Credit Application\",\n  \"contactPriorityLevel\": 1,\n  \"contactlessPriorityLevel\": 1,\n  \"printed\": true,\n  \"cardholderId\": \"20218aae-b15e-406c-9e9f-23735cd86a48\",\n  \"accountId\": \"20218aae-b15e-406c-9e9f-23735cd86a48\",\n  \"automaticRenewal\": true,\n  \"plastic\": {\n    \"embossingName\": \"John Doe\",\n    \"preferredCardDeliveryType\": \"MAIL\",\n    \"preferredPinDeliveryType\": \"MAIL\",\n    \"manufacturerId\": \"20218aae-b15e-406c-9e9f-23735cd86a48\",\n    \"externalLayoutCode\": 1\n  },\n  \"cardStatus\": \"ACTIVE\",\n  \"impactTokenStatus\": true,\n  \"pinStatus\": \"GENERATED\",\n  \"additionalValues\": {\n    \"keyWithPlainTextValue\": \"value1\",\n    \"keyWithBase64Value\": \"dmFsdWUyYmFzZTY0ZW5jb2RlZA==\"\n  },\n  \"feeConfigId\": \"SILVER\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/issuer/v1/cards/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"chipEnabled\": true,\n  \"digitalLayoutCode\": 9,\n  \"applicationName\": \"Credit Application\",\n  \"contactPriorityLevel\": 1,\n  \"contactlessPriorityLevel\": 1,\n  \"printed\": true,\n  \"cardholderId\": \"20218aae-b15e-406c-9e9f-23735cd86a48\",\n  \"accountId\": \"20218aae-b15e-406c-9e9f-23735cd86a48\",\n  \"automaticRenewal\": true,\n  \"plastic\": {\n    \"embossingName\": \"John Doe\",\n    \"preferredCardDeliveryType\": \"MAIL\",\n    \"preferredPinDeliveryType\": \"MAIL\",\n    \"manufacturerId\": \"20218aae-b15e-406c-9e9f-23735cd86a48\",\n    \"externalLayoutCode\": 1\n  },\n  \"cardStatus\": \"ACTIVE\",\n  \"impactTokenStatus\": true,\n  \"pinStatus\": \"GENERATED\",\n  \"additionalValues\": {\n    \"keyWithPlainTextValue\": \"value1\",\n    \"keyWithBase64Value\": \"dmFsdWUyYmFzZTY0ZW5jb2RlZA==\"\n  },\n  \"feeConfigId\": \"SILVER\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/issuer/v1/cards/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"chipEnabled\": true,\n  \"digitalLayoutCode\": 9,\n  \"applicationName\": \"Credit Application\",\n  \"contactPriorityLevel\": 1,\n  \"contactlessPriorityLevel\": 1,\n  \"printed\": true,\n  \"cardholderId\": \"20218aae-b15e-406c-9e9f-23735cd86a48\",\n  \"accountId\": \"20218aae-b15e-406c-9e9f-23735cd86a48\",\n  \"automaticRenewal\": true,\n  \"plastic\": {\n    \"embossingName\": \"John Doe\",\n    \"preferredCardDeliveryType\": \"MAIL\",\n    \"preferredPinDeliveryType\": \"MAIL\",\n    \"manufacturerId\": \"20218aae-b15e-406c-9e9f-23735cd86a48\",\n    \"externalLayoutCode\": 1\n  },\n  \"cardStatus\": \"ACTIVE\",\n  \"impactTokenStatus\": true,\n  \"pinStatus\": \"GENERATED\",\n  \"additionalValues\": {\n    \"keyWithPlainTextValue\": \"value1\",\n    \"keyWithBase64Value\": \"dmFsdWUyYmFzZTY0ZW5jb2RlZA==\"\n  },\n  \"feeConfigId\": \"SILVER\"\n}"

response = http.request(request)
puts response.read_body

{
  "description": "<string>",
  "id": "20218aae-b15e-406c-9e9f-23735cd86a48"
}

{
  "type": "about:blank",
  "title": "Bad Request",
  "status": 400,
  "detail": "JSON parse error: Unexpected character...",
  "instance": "/v1/cards",
  "id": "5cc541cb-f456-4331-b537-d2380fca0400",
  "timestamp": "2026-02-24T12:34:56Z"
}

{
  "type": "about:blank",
  "title": "Forbidden",
  "status": 403,
  "detail": "Access Denied",
  "instance": "/v1/cards",
  "id": "5cc541cb-f456-4331-b537-d2380fca0403",
  "timestamp": "2026-02-24T12:34:56Z"
}

{
  "type": "about:blank",
  "title": "Not Found",
  "status": 404,
  "detail": "Entity not found - Program with id: 2ec117b7-454e-4cc5-8b89-dea5485aab2b",
  "instance": "/v1/cards",
  "id": "5cc541cb-f456-4331-b537-d2380fca0404",
  "timestamp": "2026-02-24T12:34:56Z"
}

{
  "type": "about:blank",
  "title": "Conflict",
  "status": 409,
  "detail": "Customer number is not unique.",
  "instance": "/v1/cardholders",
  "id": "5cc541cb-f456-4331-b537-d2380fca0409",
  "timestamp": "2026-02-26T10:34:47.522+00:00"
}

{
  "type": "about:blank",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "Unexpected error occurred.",
  "instance": "/v1/cards",
  "id": "5cc541cb-f456-4331-b537-d2380fca0500",
  "timestamp": "2026-02-24T12:34:56Z"
}

PATCH

cards

{id}

Partially Update Card

curl --request PATCH \
  --url 'https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/issuer/v1/cards/{id}' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "chipEnabled": true,
  "digitalLayoutCode": 9,
  "applicationName": "Credit Application",
  "contactPriorityLevel": 1,
  "contactlessPriorityLevel": 1,
  "printed": true,
  "cardholderId": "20218aae-b15e-406c-9e9f-23735cd86a48",
  "accountId": "20218aae-b15e-406c-9e9f-23735cd86a48",
  "automaticRenewal": true,
  "plastic": {
    "embossingName": "John Doe",
    "preferredCardDeliveryType": "MAIL",
    "preferredPinDeliveryType": "MAIL",
    "manufacturerId": "20218aae-b15e-406c-9e9f-23735cd86a48",
    "externalLayoutCode": 1
  },
  "cardStatus": "ACTIVE",
  "impactTokenStatus": true,
  "pinStatus": "GENERATED",
  "additionalValues": {
    "keyWithPlainTextValue": "value1",
    "keyWithBase64Value": "dmFsdWUyYmFzZTY0ZW5jb2RlZA=="
  },
  "feeConfigId": "SILVER"
}
'

import requests

url = "https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/issuer/v1/cards/{id}"

payload = {
    "chipEnabled": True,
    "digitalLayoutCode": 9,
    "applicationName": "Credit Application",
    "contactPriorityLevel": 1,
    "contactlessPriorityLevel": 1,
    "printed": True,
    "cardholderId": "20218aae-b15e-406c-9e9f-23735cd86a48",
    "accountId": "20218aae-b15e-406c-9e9f-23735cd86a48",
    "automaticRenewal": True,
    "plastic": {
        "embossingName": "John Doe",
        "preferredCardDeliveryType": "MAIL",
        "preferredPinDeliveryType": "MAIL",
        "manufacturerId": "20218aae-b15e-406c-9e9f-23735cd86a48",
        "externalLayoutCode": 1
    },
    "cardStatus": "ACTIVE",
    "impactTokenStatus": True,
    "pinStatus": "GENERATED",
    "additionalValues": {
        "keyWithPlainTextValue": "value1",
        "keyWithBase64Value": "dmFsdWUyYmFzZTY0ZW5jb2RlZA=="
    },
    "feeConfigId": "SILVER"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    chipEnabled: true,
    digitalLayoutCode: 9,
    applicationName: 'Credit Application',
    contactPriorityLevel: 1,
    contactlessPriorityLevel: 1,
    printed: true,
    cardholderId: '20218aae-b15e-406c-9e9f-23735cd86a48',
    accountId: '20218aae-b15e-406c-9e9f-23735cd86a48',
    automaticRenewal: true,
    plastic: {
      embossingName: 'John Doe',
      preferredCardDeliveryType: 'MAIL',
      preferredPinDeliveryType: 'MAIL',
      manufacturerId: '20218aae-b15e-406c-9e9f-23735cd86a48',
      externalLayoutCode: 1
    },
    cardStatus: 'ACTIVE',
    impactTokenStatus: true,
    pinStatus: 'GENERATED',
    additionalValues: {
      keyWithPlainTextValue: 'value1',
      keyWithBase64Value: 'dmFsdWUyYmFzZTY0ZW5jb2RlZA=='
    },
    feeConfigId: 'SILVER'
  })
};

fetch('https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/issuer/v1/cards/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/issuer/v1/cards/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PATCH",
  CURLOPT_POSTFIELDS => json_encode([
    'chipEnabled' => true,
    'digitalLayoutCode' => 9,
    'applicationName' => 'Credit Application',
    'contactPriorityLevel' => 1,
    'contactlessPriorityLevel' => 1,
    'printed' => true,
    'cardholderId' => '20218aae-b15e-406c-9e9f-23735cd86a48',
    'accountId' => '20218aae-b15e-406c-9e9f-23735cd86a48',
    'automaticRenewal' => true,
    'plastic' => [
        'embossingName' => 'John Doe',
        'preferredCardDeliveryType' => 'MAIL',
        'preferredPinDeliveryType' => 'MAIL',
        'manufacturerId' => '20218aae-b15e-406c-9e9f-23735cd86a48',
        'externalLayoutCode' => 1
    ],
    'cardStatus' => 'ACTIVE',
    'impactTokenStatus' => true,
    'pinStatus' => 'GENERATED',
    'additionalValues' => [
        'keyWithPlainTextValue' => 'value1',
        'keyWithBase64Value' => 'dmFsdWUyYmFzZTY0ZW5jb2RlZA=='
    ],
    'feeConfigId' => 'SILVER'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/issuer/v1/cards/{id}"

	payload := strings.NewReader("{\n  \"chipEnabled\": true,\n  \"digitalLayoutCode\": 9,\n  \"applicationName\": \"Credit Application\",\n  \"contactPriorityLevel\": 1,\n  \"contactlessPriorityLevel\": 1,\n  \"printed\": true,\n  \"cardholderId\": \"20218aae-b15e-406c-9e9f-23735cd86a48\",\n  \"accountId\": \"20218aae-b15e-406c-9e9f-23735cd86a48\",\n  \"automaticRenewal\": true,\n  \"plastic\": {\n    \"embossingName\": \"John Doe\",\n    \"preferredCardDeliveryType\": \"MAIL\",\n    \"preferredPinDeliveryType\": \"MAIL\",\n    \"manufacturerId\": \"20218aae-b15e-406c-9e9f-23735cd86a48\",\n    \"externalLayoutCode\": 1\n  },\n  \"cardStatus\": \"ACTIVE\",\n  \"impactTokenStatus\": true,\n  \"pinStatus\": \"GENERATED\",\n  \"additionalValues\": {\n    \"keyWithPlainTextValue\": \"value1\",\n    \"keyWithBase64Value\": \"dmFsdWUyYmFzZTY0ZW5jb2RlZA==\"\n  },\n  \"feeConfigId\": \"SILVER\"\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.patch("https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/issuer/v1/cards/{id}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"chipEnabled\": true,\n  \"digitalLayoutCode\": 9,\n  \"applicationName\": \"Credit Application\",\n  \"contactPriorityLevel\": 1,\n  \"contactlessPriorityLevel\": 1,\n  \"printed\": true,\n  \"cardholderId\": \"20218aae-b15e-406c-9e9f-23735cd86a48\",\n  \"accountId\": \"20218aae-b15e-406c-9e9f-23735cd86a48\",\n  \"automaticRenewal\": true,\n  \"plastic\": {\n    \"embossingName\": \"John Doe\",\n    \"preferredCardDeliveryType\": \"MAIL\",\n    \"preferredPinDeliveryType\": \"MAIL\",\n    \"manufacturerId\": \"20218aae-b15e-406c-9e9f-23735cd86a48\",\n    \"externalLayoutCode\": 1\n  },\n  \"cardStatus\": \"ACTIVE\",\n  \"impactTokenStatus\": true,\n  \"pinStatus\": \"GENERATED\",\n  \"additionalValues\": {\n    \"keyWithPlainTextValue\": \"value1\",\n    \"keyWithBase64Value\": \"dmFsdWUyYmFzZTY0ZW5jb2RlZA==\"\n  },\n  \"feeConfigId\": \"SILVER\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.{{tenant}}.ext-uat1-sandbox.mycore.enfuce.com/issuer/v1/cards/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Patch.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"chipEnabled\": true,\n  \"digitalLayoutCode\": 9,\n  \"applicationName\": \"Credit Application\",\n  \"contactPriorityLevel\": 1,\n  \"contactlessPriorityLevel\": 1,\n  \"printed\": true,\n  \"cardholderId\": \"20218aae-b15e-406c-9e9f-23735cd86a48\",\n  \"accountId\": \"20218aae-b15e-406c-9e9f-23735cd86a48\",\n  \"automaticRenewal\": true,\n  \"plastic\": {\n    \"embossingName\": \"John Doe\",\n    \"preferredCardDeliveryType\": \"MAIL\",\n    \"preferredPinDeliveryType\": \"MAIL\",\n    \"manufacturerId\": \"20218aae-b15e-406c-9e9f-23735cd86a48\",\n    \"externalLayoutCode\": 1\n  },\n  \"cardStatus\": \"ACTIVE\",\n  \"impactTokenStatus\": true,\n  \"pinStatus\": \"GENERATED\",\n  \"additionalValues\": {\n    \"keyWithPlainTextValue\": \"value1\",\n    \"keyWithBase64Value\": \"dmFsdWUyYmFzZTY0ZW5jb2RlZA==\"\n  },\n  \"feeConfigId\": \"SILVER\"\n}"

response = http.request(request)
puts response.read_body

{
  "description": "<string>",
  "id": "20218aae-b15e-406c-9e9f-23735cd86a48"
}

{
  "type": "about:blank",
  "title": "Bad Request",
  "status": 400,
  "detail": "JSON parse error: Unexpected character...",
  "instance": "/v1/cards",
  "id": "5cc541cb-f456-4331-b537-d2380fca0400",
  "timestamp": "2026-02-24T12:34:56Z"
}

{
  "type": "about:blank",
  "title": "Forbidden",
  "status": 403,
  "detail": "Access Denied",
  "instance": "/v1/cards",
  "id": "5cc541cb-f456-4331-b537-d2380fca0403",
  "timestamp": "2026-02-24T12:34:56Z"
}

{
  "type": "about:blank",
  "title": "Not Found",
  "status": 404,
  "detail": "Entity not found - Program with id: 2ec117b7-454e-4cc5-8b89-dea5485aab2b",
  "instance": "/v1/cards",
  "id": "5cc541cb-f456-4331-b537-d2380fca0404",
  "timestamp": "2026-02-24T12:34:56Z"
}

{
  "type": "about:blank",
  "title": "Conflict",
  "status": 409,
  "detail": "Customer number is not unique.",
  "instance": "/v1/cardholders",
  "id": "5cc541cb-f456-4331-b537-d2380fca0409",
  "timestamp": "2026-02-26T10:34:47.522+00:00"
}

{
  "type": "about:blank",
  "title": "Internal Server Error",
  "status": 500,
  "detail": "Unexpected error occurred.",
  "instance": "/v1/cards",
  "id": "5cc541cb-f456-4331-b537-d2380fca0500",
  "timestamp": "2026-02-24T12:34:56Z"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-audit-user

string

Optional audit user header

Path Parameters

string<uuid>

required

Unique identifier of the card that you want to update.

Body

application/json

Details of the card that you want to update.

chipEnabled

boolean

Whether the card should be visible in card terminal or not. Only applicable to multi-application cards. Otherwise, the request will return 400 Bad Request.

Example:

true

digitalLayoutCode

string

The digital layout code for the card. Max character limit is 36.

Required string length: 1 - 36

Pattern: ^[a-zA-Z0-9-]+$

Example:

9

applicationName

string

Name of the application. Max character limit is 16. Only applicable to multi-application cards. Otherwise, the request will return 400 Bad Request.

Required string length: 1 - 16

Pattern: ^[a-zA-Z ]+$

Example:

"Credit Application"

contactPriorityLevel

integer<int32>

The contact priority level for given card. Only applicable to multi-application cards. Otherwise, the request will return 400 Bad Request.

Required range: x >= 0

contactlessPriorityLevel

integer<int32>

The contactless priority level of the given card. Only applicable to multi-application cards. Otherwise, the request will return 400 Bad Request.

Required range: x >= 0

printed

boolean

Indicates whether the specific card would be printed or not. Only applicable to multi-application cards. Otherwise, the request will return 400 Bad Request.

Example:

true

cardholderId

string<uuid>

Unique identifier of a resource.

Example:

"20218aae-b15e-406c-9e9f-23735cd86a48"

accountId

string

Unique identifier of an account.

Required string length: 1 - 36

Pattern: ^[a-zA-Z0-9-]+$

Example:

"20218aae-b15e-406c-9e9f-23735cd86a48"

automaticRenewal

boolean

A flag indicating whether automatic renewal is enabled or not.

plastic

object

Show child attributes

cardStatus

enum<string>

ACTIVE - Card is active and is enabled for normal usage.
BLOCKED - Card is temporarily blocked.
BLOCKED_SUSPECTED_FRAUD - Card is temporarily blocked due to suspected fraud.
CLOSED_DUE_TO_FRAUD - Card has been closed due to fraud.
CLOSED_LOST - Card has been closed due to being lost.
CLOSED_STOLEN - Card has been closed due to being stolen.
CLOSED - Card has been manually closed.
CLOSED_EXPIRED - Card has no active or initial card versions and cannot be used.

Available options:

ACTIVE,

BLOCKED,

BLOCKED_SUSPECTED_FRAUD,

CLOSED_DUE_TO_FRAUD,

CLOSED_LOST,

CLOSED_STOLEN,

CLOSED,

CLOSED_EXPIRED

Example:

"ACTIVE"

impactTokenStatus

boolean

default:true

If set to true, the card status change will impact the status of all tokens. If set to false, the card status change will not impact the status of all tokens.

pinStatus

enum<string>

GENERATED - A pin should be randomly generated for the card.

Available options:

GENERATED

Example:

"GENERATED"

additionalValues

object

You can include up to 30 additional key-value pairs in the embossing file sent to the card manufacturer.

Keys must follow the pattern: ^[a-zA-Z0-9-]{1,36}$ (only letters, numbers, and hyphens, with a maximum length of 36 characters).
Values must follow the pattern: ^[a-zA-Z0-9|\-_ +.@éàèùçâêîôûëïü'/=]{1,1000}$.

Enfuce does not perform any additional validation on these key-value pairs beyond ensuring they match the specified patterns.

These fields are intended for storing data without further processing. If you need to store a complex structure, you can base64 encode the value. The encoded value will be passed as entered, without modifications.

⚠ Important: Any usage of these fields should be agreed upon with the manufacturer.

Show child attributes

Example:

{
  "keyWithPlainTextValue": "value1",
  "keyWithBase64Value": "dmFsdWUyYmFzZTY0ZW5jb2RlZA=="
}

feeConfigId

string | null

Unique identifier of a fee configuration. When provided, this value overrides the program default. This feature must be enabled for the tenant; otherwise, this field can be left null and will not be used.

Required string length: 1 - 36

Pattern: ^[a-zA-Z0-9_-]+$

Example:

"SILVER"

Response

Successful update of the card.

description

string

A description of the response returned.

string<uuid>

A unique identifier assigned to identify the endpoint request.

Example:

"20218aae-b15e-406c-9e9f-23735cd86a48"

⌘I

Introduction

Cards API

Cardholders API

PIN API

Wallet API

Transaction Lifecycle

Spend Controls API

Exchange Rates API

Partially Update Card

Authorizations

Headers

Path Parameters

Body

Response