COMING SOON

Reissue a Card

Reissue a card. RocketKOR keeps a history of reissued cards, allowing you to track the reissued date and reason for reissuance.

The following use cases are supported for reissuing cards:

Same card number and expiry date (for example, if the card has been damaged).
- changeCardNumber must be set to false
- changeExpiryDate must be set to false
Same card number and a new expiry date (for example, if the card will expire soon).
- changeCardNumber must be set to false
- changeExpiryDate must be set to true
New card number (for example, if the card has been lost or stolen).
- changeCardNumber must be set to true
- changeExpiryDate will be ignored (the expiry date is always changed if a card is reissued with a new number)

When reissuing a card, you can also change the name printed on the card, choose the shipping method for the reissued card, and reissue the card under a different Card Program ID.

To reissue a card, you will need:

ID of the integrated Financial Account for the card
Reissue reason

Reissued cards are shipped in an inactive state. Use the Activate Card API to activate a card once it has been received by the Customer.

Endpoint

POST /v1/integrated-cards/{financialAccountId}/reissue

Authorization Header

Authorization: Bearer <access_token>

Idempotency-Key Header

Idempotency-Key: <key>

where <key> is a v4 UUID or any other unique string with a minimum length of 6 characters and a maximum length of 255 characters.

The idempotency key identifies the request. If a network error occurs, you can safely retry the request using the same idempotency key and the request will only be executed once. This ensures that calling the API multiple times will not result in duplicate requests. For more information, see Idempotent Calls.

Path Parameters

financialAccountId REQUIRED

string (UUID)

ID of the integrated Financial Account. The issued card is linked to this Financial Account.

Request Body

reissueReason REQUIRED

string enum, values: DAMAGED, EXPIRED, LOST_STOLEN, FRAUD_COMPROMISED, RETURN, NEW_ENROLLMENT

Reason the card was reissued. The following values are supported:

DAMAGED Card has been damaged.
EXPIRED Card has expired.
LOST_STOLEN Card has been lost or stolen.
FRAUD_COMPROMISED Card has been used for fraudulent charges.
RETURN Card has been returned.
NEW_ENROLLMENT New enrollment.

changeCardNumber

boolean, default: false

Whether to use a new card number for the reissued card.

changeExpiryDate

boolean, default: false

Whether to use a new expiry date for the reissued card.

shippingMethod

string enum, values: NORMAL, URGENT, VIP, BULK, BULK_URGENT, BULK_VIP

default value: NORMAL

Card shipping method. The following values are supported:

NORMAL Normal shipment.
URGENT Urgent shipment.
VIP VIP shipment.
BULK Bulk shipment.
BULK_URGENT Urgent bulk shipment.
BULK_VIP VIP bulk shipment.

newProgramId

string

Card Program ID. If provided, the card will be reissued using this Card Program.

nameOnCard

string

If provided, this name will be printed on the reissued card.

Returns

Returns the Issued Card Financial Account object. This object contains details about the integrated Financial Account, the Issued Card object (which contains details for the issued card), and the Issued Card Provider Details object (which contains provider details for the issued card).

SAMPLE REQUEST

				
					{
  "reissueReason": "DAMAGED",
  "changeCardNumber": false,
  "changeExpiryDate": false,
  "shippingMethod": "NORMAL"
  "newProgramId": "123",
  "nameOnCard": "John Smith"
}

SAMPLE RESPONSE

				
					{
  "id": "7d08a89d-2ac5-4ed3-a6ca-ad7c974c994e",
  "parentId": "",
  "businessAccountId": "b535dce9-b71a-4f7b-b27f-73e47b13e7a5",
  "name": "Debit Card",
  "category": "INTEGRATED",
  "type": "CARD",
  "subtype": "DEBIT",
  "defaultFlag": false,
  "currency": "USD",
  "accountHolderId": "6d0b12d8-6e9d-4021-85da-b42ab3845f11",
  "accountHolderType": "CUSTOMER",
  "state": "ACTIVE",
  "stateReason": "CARD_ACTIVATED",
  "maskedAccountNumber": "******4823",
  "createdBy": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "type": "employee"
  },
  "createdAt": "2021-09-20T22:09:31.947Z",
  "updatedBy": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "type": "employee"
  },
  "updatedAt": "2021-10-20T22:09:31.947Z",
  "card": {
    "firstName": "Mark",
    "middleName": "David",
    "lastName": "Strong",
    "cardNumberTail": "4242",
    "expiry": "2027-12",
    "billingAddress": {
      "addressLine1": "625 Queen St",
      "addressLine2": "",
      "addressLine3": "",
      "city": "Vancouver",
      "stateCode": "BC",
      "countryCode": "CAN",
      "postalCode": "V5K 0A1"
    }
  },
  "_embedded": {
    "providerDetails": {
      "solution": "card-issuing",
      "startingNumber": "412345",
      "programId": "123",
      "shippingMethod": "NORMAL",
      "extraEmbossingLine": "",
      "usCitizen": true,
      "referralSource": "www.abc.com",
      "acceptedTermsDate": "2023-02-09",
      "readPrivacyPolicyDate": "2023-02-09",
      "acceptedAgreement": true,
      "alertTypes": "ADMIN_ONLY",
      "issuedLanguageCode": "en_US",
      "cardNumber": "412345987442231477",
      "expiry": "2027-12",
      "nameOnCard": "John Smith",
      "issuedDateTime": "2023-02-09",
      "reissueDateTime": "2023-03-09",
      "reissueType": "REISSUED_FOR_SAME_CARD_NUMBER",
      "reissueReason": "DAMAGED",
      "externalBankAccount": {
        "bankName": "Citibank",
        "routingNo": "228264850",
        "accountNumber": "16322",
        "accountNumberTail": "22",
        "nameOnAccount": "Mary Jones",
        "businessName": "ABC Corporation"
      },
      "externalCardReferenceId": "123456",
      "fulfillmentHouse": "123456"
    }
  }
}