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