COMING SOON
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:
POST /v1/integrated-cards/{financialAccountId}/activate
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.
newPin REQUIRED
string, min length: 4, max length: 12
New PIN for the card. Must be provided as an encrypted PIN block.
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
{
"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",
"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"
}
}
}
© 2022 Rocket Financial. All rights reserved. RocketFNCL, RocketKOR, RocketBNK are trade names of Rocket Financial Inc.
Services Agreement | Privacy Policy | RocketFNCL | © 2023 by Rocket Financial Inc. All rights reserved.
Services Agreement | Privacy Policy | RocketFNCL | © 2023 by Rocket Financial Inc. All rights reserved.
Services Agreement | Privacy Policy | RocketFNCL
© 2023 by Rocket Financial Inc. All rights reserved.