RocketKOR

COMING SOON

Issued Card Object

The Issued Card object represents the issued card attached to an integrated Financial Account. An issued card can be a debit card, credit card, prepaid card, or gift card.

Attributes

solution  

string

Name of the RocketKOR solution used for the card issuance.

startingNumber  

string

Starting numbers for the card as defined in the Card Program. These numbers identify the card BIN (Bank Identification Number) and the Card Program ID.

programId  

string

Card Program ID.

shippingMethod

string enum, values: NORMAL, URGENT, VIP, BULK, BULK_URGENT, BULK_VIP, default: 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.

extraEmbossingLine

string

Information to print on the 4th embossing line of the card.

usCitizen  

boolean

Whether the Customer is a citizen of the United States.

referralSource

string

Referral link/URL in the client application that is the source of the request.

acceptedTermsDate  

string (date), required format: yyyy-MM-dd

Date that the terms and conditions were accepted in the client application.

readPrivacyPolicyDate  

string (date), required format: yyyy-MM-dd

Date the privacy policy was marked as read in the client application.

acceptedAgreement  

boolean

Whether the cardholder agreement was accepted in the client application.

alertTypes

string enum, values: ADMIN_ONLY, ADMIN_PROMO, NEITHER

Type of alerts to send to the Customer. The following values are supported:

  • ADMIN_ONLY  Administrative alerts only
  • ADMIN_PROMO  Administrative and promotional alerts
  • NEITHER  No alerts

issuedLanguageCode

string

Language code for the language in which the card is issued. The following values are supported:

  • en  English
  • es  Espanol
  • fr  French
  • en_US  English/US
  • es_US  Espanol/US
  • pt  Portugues

cardNumber  

string, min length: 11, max length: 19

Card number.

expiry  

string, required format: YYYY-MM

Expiry date for the card.

nameOnCard

string, max length: 60, min length: 1

Customer’s name as it appears on the card.

issuedDateTime

string (date)

Date and time the card was issued.

reissueDateTime

string (date)

Date and time the card was reissued.

reissueType

string enum, values: REISSUED_FOR_NEW_CARD_NUMBER, REISSUED_FOR_NEW_EXPIRY, REISSUED_FOR_SAME_CARD_NUMBER

Type of reissue. The following values are supported:

  • REISSUED_FOR_NEW_CARD_NUMBER  New card number.
  • REISSUED_FOR_NEW_EXPIRY  New expiry date. The card number remains the same.
  • REISSUED_FOR_SAME_CARD_NUMBER  Same card number and same expiry date.

reissueReason  

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.

externalBankAccount

object

Bank Account information for the Financial Account.

bankName

string

Name of the financial institution.

routingNo  

string, max length: 9

Routing number for the financial institution.

accountNumber  

string, max length: 20

Bank account number.

accountNumberTail

string, max length: 4

Last 4 digits of the bank account number.

nameOnAccount

string, max length: 40, min length: 1

Name of the bank account owner.

businessName

string, max length: 40, min length: 1

Business name as it appears on the bank account.

externalCardReferenceId

string

Card reference number in the external provider system.

Issued Card Object

				
					{
  "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"
}