v1

latestOpenAPI 3.0.12026-07-24501176.6 MB

Update Card Details (Bulk)

Lets you update details of existing cards in bulk. You can update details such as card status label, and custom/extended field values.

put/card/bulk

Request body

seriesIdinteger

Unique ID of the card series associated with the card.

cardNumberstring required

Unique number of the card to add details. Either cardNumber or cardExternalId is mandatory.

cardExternalIdstring

External reference ID of the card. Either cardNumber or cardExternalId is mandatory.

statusLabelstring

Current user defined status of the card. Check your user defined values for the system values (not issued, active, inactive, deleted, expired).

customFieldsobject

Card level custom field details in key:value pair.

extendedFieldsobject

Card level extended field details in key:value pair.

mappedEntityobject

Details of the TILL associated with the card issual.

Response

200

totalCountinteger
failureCountinteger

Example response

{
  "response": [
    {
      "entityId": {
        "cardId": 417,
        "extendedFields": {
          "limit_set_by": "tom",
          "year_of_registration": 36
        },
        "customFields": {
          "cardstatus": "na"
        },
        "mappedEntity": {
          "type": "TILL",
          "value": "paw1",
          "id": 50016843
        },
        "cardNumber": "visasushi005",
        "orgId": 50247,
        "entityId": 50016843,
        "statusLabelInfo": {
          "createdOn": "2021-11-23",
          "entityStatusId": 1,
          "id": 24,
          "isActive": true,
          "label": "not_issued",
          "orgId": 50247,
          "updatedOn": "2021-11-23",
          "status": "NOT_ISSUED",
          "type": "CARD",
          "default": true
        }
      },
      "warnings": [
        {
          "message": "No update in status label",
          "code": 3039
        }
      ]
    }
  ],
  "totalCount": 2
}