Reissue
Request URL
POST /condor/card/re-issue
(deprecated)
Description
This endpoint is deprecated. Instead of using /condor endpoints, it is recommended to use /ibis endpoints. Ibis endpoints support credit-card issuing, debit-card issuing, and vAccount issuing.
This endpoint will reissue an existing debit card. Cards with a status of "CLOSED" or "FRAUD_BLOCK" cannot be reissued. If a card with a "BLOCK" status is reissued, its status will remain as "BLOCK" and will still be inactive.
Required Properties | Description | Schema | Example Values |
---|---|---|---|
cardId | Card ID in connectFi | String | "crda_gYVPQlVLIW0QETZzLQg1i1" |
cardAttributes | Attributes of the card - unlike the /condor/card/create request, the only required cardAttribute property for this endpoint is the issueType | Object | See cardAttributes Object below |
cardAttributes Object
Required Properties | Description | Schema | Example Values |
---|---|---|---|
issueType | Description identifying issue category of card | String | "NEW", "REGISTRATION", "RE-ISSUE", "EXPIRED", or "DAMAGED" |
Optional Properties | Description | Schema | Example Values |
---|---|---|---|
reference | An external alphanumeric reference ID (1-20 characters) for the card in your system | String, regex pattern "^[0-9a-zA-Z]+$" | "externalCrdId1234" |
productID | Product ID of card | String | "Virtual_Debit_Card" |
nameOnCard | Full customer name that will appear on the card | String | "JESSIE U TESTMAN" |
cardShippingMethod | Shipping method chosen for card | String | "Standard" |
designId | An ID representing the design chosen for the card | String | "1" |
addressType | Type of address | String | "PRIMARY" or "SECONDARY" |
additionalData | An object containing any necessary additional key:value pair properties not listed elsewhere | Object | {"someProperty" : "Property value"} |
Request Body
HEADERS
{
"Content-Type": "application/json",
"x-connectfi-token": "a long random string" //Authorization token received from /auth/get-token request
}
REQUEST BODY
{
"cardId" : "crda_5ovuxBHc9DSTsXjv4LpJO4", //card ID in connectFi
"cardAttributes": {
"issueType" : "DAMAGED"
}
}
Successful Response Example
200 (HTTP response status code) -- Success, card was reissued
{
"code": "0", //Success
"data": {
"last_four": "####", //last 4 digits on the card, #### is used as a placeholder here for documentation purposes
"status": "NEW",
"program_id": "Virtual_Debit_Card",
"name_on_card": "SUSAN TESTMAN UWUR 3",
"available_balance": 0, //amount that has been loaded onto the card
"currency_code": "USD",
"additional_data": {
"account_number": "##############", //customer account number corresponding to the new card, ############## is used as a placeholder for documentation purposes
"issue_date": "2022-10-13T16:25:48.915766Z",
"design_id": "1",
"designId": "1",
"card_expiration": "112025",
"processor_token": "369029384829",
"routing_number": "#########" //a US ABA account routing number, ######### is used as a placeholder here for documentation purposes
"accountId": "acca_5pPqA1imoRrOtoC8i8QTGk" //account ID in connectFi
},
"cardId": "crda_5ovuxBHc9DSTsXjv4LpJO4" //card ID in connectFi
}
}
Errors
400 (HTTP response status code) -- Card is closed, cannot be reissued
In this example, a request to reissue a card that has a "CLOSED" status was attempted.
{
"code": "extCondor",
"subCode": "C1022",
"context": {
"title": "cardsPost"
},
"message": "Card is Closed, cannot be reissued."
}
400 (HTTP response status code) -- Suspected Fraud Hit
In this example, an attempt was made to reissue a card that has status code "FRAUD_BLOCK" and this indicates a suspected fraud hit.
{
"code": "extCondor",
"subCode": "C0010",
"context": {
"title": "cardsPost"
},
"message": "Reissue Card Decline (Suspected Fraud Hit, Card is Already Blocked)"
}
400 (HTTP response status code) -- Must be equal to one of the allowed values
In this example, an invalid issueType value was included in the request.
{
"code": "requestValidateError",
"context": [
{
"instancePath": "/cardAttributes/issueType",
"schemaPath": "#/properties/issueType/enum",
"keyword": "enum",
"params": {
"allowedValues": [
"NEW",
"REGISTRATION",
"RE-ISSUE",
"EXPIRED",
"DAMAGED"
]
},
"message": "must be equal to one of the allowed values"
}
]
}