Reissue a card

POST 
/cards/:cardId/reissue

If a physical card has already been created for a user, it can be reissued on request.

Reissuing cards requires a reason code, as follows:

1: Damaged: Retains PAN / new CVV / new expiry date.

2: Expired: Retains PAN / new CVV / new expiry date.

3: Lost/Stolen: New PAN / new CVV / new expiry date.

4: Fraud/Compromised: New PAN / new CVV / new expiry date.

5: Return: Retains PAN / new CVV / new expiry date.

6: New Enrolment New PAN / new CVV / new expiry date.

Cards that are currently in transit cannot be reissued and will return an error.

Reissue types: 1=Same Card Number with Same profile Info, 2=Same Card Number with Updated Expiry, 3=New Card Number with existing profile info

Reason codes:

• 1: Damaged: Retains PAN / new CVV / new expiry date.
• 2: Expired: Retains PAN / new CVV / new expiry date.
• 3: Lost/Stolen: New PAN / new CVV / new expiry date.
• 4: Fraud/Compromised: New PAN / new CVV / new expiry date.
• 5: Return: Retains PAN / new CVV / new expiry date.
• 6: New Enrolment New PAN / new CVV / new expiry date.

Important: Cards that are currently in transit cannot be reissued and will return an error.

Request

Path Parameters

cardId stringrequired

The ID of the card to reissue

application/json

Body

required

Reissue card data

userId stringrequired

User ID of the cardholder

reasonCode stringrequired

Possible values: [1, 2, 3, 4, 5, 6]

Reason code for reissue: "1" = Card is damaged "2" = Card has expired "3" = Card is lost or stolen "4" = Card compromised due to fraud "5" = Card returned "6" = New enrollment

reissueType string

Possible values: [1, 2, 3]

Default value: 1

Reissue type for the card: "1" = Same Card Number with Same profile Info "2" = Same Card Number with Updated Expiry "3" = New Card Number with existing profile info

Responses

201

Card reissue request processed.

application/json

Schema

Schema

traceId string
message string

data

object

reissueCardResponse

object

required

responseCode stringrequired

Response code from i2c

responseDesc string

Response description

cardNumber string

Card number

newCardReferenceId string

New card reference ID

expectedDeliveryDate string

Expected delivery date

transId string

Transaction ID

fee number

Fee

newCardNumber

object

accountNumber string

Account number associated with the card

balance string

Card or purse account balance

expiryDate string

Card expiry date

number string

Number of the existing card

Example (from schema)

{
  "traceId": "string",
  "message": "string",
  "data": {
    "reissueCardResponse": {
      "responseCode": "00",
      "responseDesc": "string",
      "cardNumber": "string",
      "newCardReferenceId": "string",
      "expectedDeliveryDate": "string",
      "transId": "string",
      "fee": 0,
      "newCardNumber": {
        "accountNumber": "string",
        "balance": "string",
        "expiryDate": "string",
        "number": "string"
      }
    }
  }
}

400

Invalid request payload. This can happen if required fields are missing or have invalid formats.

application/json

Schema

Schema

traceId string
message string

Example (from schema)

{
  "traceId": "string",
  "message": "string"
}

403

The API key is invalid or the client does not have sufficient permissions.

application/json

Schema

Schema

traceId string
message string

Example (from schema)

{
  "traceId": "string",
  "message": "string"
}

404

One of the specified resources was not found. Does not apply for empty result set.

application/json

Schema

Schema

traceId string
message string

Example (from schema)

{
  "traceId": "string",
  "message": "string"
}

412

Precondition Failed - Card cannot be reissued (e.g., previous reissued card still in shipment)

application/json

Schema

Schema

message string
traceId string

Example (from schema)

{
  "message": "Reissue Damaged Card Decline (Unable to reissue card as last reissued card is still in shipment)",
  "traceId": "02a6aa38-3087-4dfe-92aa-e003f1e65acc"
}

Loading...