PATCH
/
v3
/
{id}
curl --request PATCH \
  --url https://integration-api-cat2./%7B{environment}%7D.ext.%7B{realm}%7D.cia.enfuce.com/card/v3/{id} \
  --header 'Content-Type: application/json' \
  --data '{
  "accountId": "1234567890",
  "cardAddress": {
    "address1": "Kings street 12",
    "address2": "<string>",
    "address3": "<string>",
    "address4": "<string>",
    "city": "Mariehamn",
    "country": "FIN",
    "region": "Åland Islands",
    "zipCode": 22100
  },
  "cardDeliveryType": "CUSTOM_1",
  "customerId": "1234567890",
  "embossing": {
    "additionalField1": "<string>",
    "additionalField2": "<string>",
    "additionalField3": "<string>",
    "additionalField4": "<string>",
    "additionalField5": "<string>",
    "companyName": "Enfuce Financial Services",
    "externalLayoutCode": "BlueCard",
    "firstName": "Monica",
    "lastName": "Liikamaa",
    "manufacturer": "FACTORY_X",
    "physical": true
  },
  "pinAddress": {
    "address1": "Kings street 12",
    "address2": "<string>",
    "address3": "<string>",
    "address4": "<string>",
    "city": "Mariehamn",
    "country": "FIN",
    "region": "Åland Islands",
    "zipCode": 22100
  },
  "pinDeliveryType": "CUSTOM_1",
  "regionAndEcommBlocking": {
    "ecomm": true,
    "africa": true,
    "asia": true,
    "europe": true,
    "home": true,
    "northAmerica": true,
    "oceania": true,
    "southAmerica": true
  },
  "reason": "<string>",
  "segment": "SEGMENT_A",
  "status": "CARD_OK",
  "usageLimits": [
    {
      "code": "24H",
      "values": [
        {
          "code": "ATM",
          "reset": true,
          "singleAmount": 1000,
          "count": 5,
          "sumAmount": 1200
        }
      ]
    }
  ],
  "pinStatus": "D"
}'
{
  "description": "<string>",
  "id": "<string>"
}
Deprecated: This API endpoint is no longer supported.

Path Parameters

​
id
string
required

The card id for given card

Query Parameters

​
auditUser
string
required

The audit user to log the request

Body

application/json
The new value of selected property. You should only provide a value for the property you want to update, the other ones should be null
​
accountId
string

The account id card is linked to

Example:

"1234567890"

​
cardAddress
object

Address used to deliver card. Full address object is expected to be set when updating.

​
cardDeliveryType
enum<string>

Valid card delivery types in API

Available options:
CUSTOM_1,
CUSTOM_2,
CUSTOM_3,
CUSTOM_4,
CUSTOM_5,
MAIL,
COURIER
​
customerId
string

The customer id card is linked to

Example:

"1234567890"

​
embossing
object

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.

​
pinAddress
object

Address used to deliver pin. Full address object is expected to be set when updating.

​
pinDeliveryType
enum<string>

Valid pin delivery types in API

Available options:
CUSTOM_1,
CUSTOM_2,
CUSTOM_3,
CUSTOM_4,
CUSTOM_5,
MAIL,
COURIER,
EPIN
​
regionAndEcommBlocking
object

Card ecomm and geo-region blocking

​
reason
string

Reason for contract status change

Maximum length: 32
​
segment
enum<string>

Field enables to group an entity into a segment. This field will be exported but no logic is applied to this in Enfuce API

Available options:
SEGMENT_A,
SEGMENT_B,
SEGMENT_C,
SEGMENT_D,
SEGMENT_E,
SEGMENT_F
​
status
enum<string>
Available options:
CARD_OK,
CARD_BLOCKED,
SUSPECTED_FRAUD,
CARD_CLOSED_DUE_TO_FRAUD,
CARD_NO_RENEWAL,
CARD_LOST,
CARD_STOLEN,
CARD_CLOSED
​
usageLimits
object[]

Usage limits

​
pinStatus
enum<string>

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
Available options:
D,
W,
S

Response

200
application/json
Successful update of the card
​
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