COMING SOON

Activate a Card

All issued and reissued cards are shipped with a SUSPENDED status, meaning that the card is inactive. Once a card has been received by the Customer, use the Activate Card API to change the card status to ACTIVE and create a PIN for the card.

To activate a card, you will need:

RocketKOR PCI Compliance Status
RocketKOR encryption keys (issued during onboarding)
ID of the integrated Financial Account for the card

Endpoint

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

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 maximum length of 255 characters.

The idempotency key identifies the request. By using the same idempotency key and parameters, you can safely retry a request (for example, if there’s a network error) 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 About 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

newPin REQUIRED

string, min length: 4, max length: 12

New PIN for the card. Must be provided as an encrypted PIN block.

Returns

Returns the Issued Card Financial Account object. This object contains details about the Financial Account and the issued card that is linked to the Financial Account.

SAMPLE REQUEST

				
					{
  "newPin": "13491817"
}

SAMPLE RESPONSE

				
					{
  "id": "7d08a89d-2ac5-4ed3-a6ca-ad7c974c994e",
  "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",
  "createdAt": "2023-02-09T02:31:07.792Z",
  "updatedAt": "2023-02-11T02:31:07.793Z",
  "card": {
    "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"
  }
}