Sign in

v1

latestOpenAPI 3.0.32026-07-26208618579.9 KB
Update application

Update an application of a multi-application card

This operation will update given fields given a card id

patch/v1/application/{id}

Path parameters

idstring biginteger required

The main card id for given card

Query parameters

auditUserstring required

The audit user to log the request

Request body

applicationNamestring

Name of the application displayed on the POS terminal in text

enabledboolean

Allows to define if an application (PAN) is active on the chip. Only active applications are displayed

printedboolean

To indicate if this PAN is printed on the physical card

contactPriorityLevelinteger

Priority level of the application (PAN) on a POS terminal (Lowest is the first application listed)

contactlessPriorityLevelinteger

Priority level of the contactless application (PAN) (not visible on terminal). Application with the lowest value will be used for contactless purchases

digitalLayoutCodestring

Id used for digital wallet artwork and other related assets. Use of this need to be agreed with Enfuce separately

status'CARD_OK' | 'CARD_BLOCKED' | 'SUSPECTED_FRAUD' | 'CARD_CLOSED_DUE_TO_FRAUD' | 'CARD_NO_RENEWAL' | 'CARD_LOST' | 'CARD_STOLEN' | 'CARD_CLOSED' | 'CARD_EXPIRED'
  • CARD_OK - Card is open and in normal status. Card has to be in this status in order for it to be renewed - CARD_BLOCKED - Temporary block on the card that will prevent approval of authorisations. Can be used instead of account level temporary block if target is to block only a specific card - SUSPECTED_FRAUD - Temporary block on the card that will prevent approval of authorisations. Functionality the same as for "Card blocked", the different code allows to differentiate between the blocks - CARD_CLOSED_DUE_TO_FRAUD - Used to close a card due to known fraud - CARD_NO_RENEWAL - Status set to prevent following card renewal. Does not affect card functionality in any way, only renewal - CARD_LOST - Used to close a card because it is lost - CARD_STOLEN - Used to close a card because it is stolen - CARD_CLOSED - Used to close card by request from customer or bank, reason for closure is set with status update reason. Allows still clearing transaction posting - CARD_EXPIRED - Final card closure status, that blocks also clearing transaction posting

Example request

{
  "applicationName": "APPLICATION",
  "digitalLayoutCode": "abc123abc",
  "usageLimits": [
    {
      "values": [
        {
          "reset": true,
          "singleAmount": 1000,
          "count": 5,
          "sumAmount": 1200
        }
      ]
    }
  ]
}

Response

Successful update of the card

descriptionstring

Short description of the result of the action

idstring

Will contain the ID of the resource that has been created or updated