COMING SOON
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:
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:
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.
POST /v1/integrated-cards/{financialAccountId}/reissue
Authorization: Bearer <access_token>
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.
financialAccountId REQUIRED
string (UUID)
ID of the integrated Financial Account. The issued card is linked to this Financial Account.
reissueReason REQUIRED
string enum, values: DAMAGED, EXPIRED, LOST_STOLEN, FRAUD_COMPROMISED, RETURN, NEW_ENROLLMENT
Reason the card was reissued. The following values are supported:
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:
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 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"
}
}
}
Step into the future of Finance with RocketKOR! Simplify payments, banking, lending, and data analytics using our versatile KOR Platform.
A Rocket Financial Inc. company
@ 2023 RocketKOR, Inc. All rights reserved.