Set Status

Request URL

POST /condor/card/change-status (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 type of request is used to change the status of a debit card. Valid status values are:

"ACTIVE" - Open, all actions allowed
"BLOCK" - Inactive, cannot set PIN or activate card through the /condor/card/activate endpoint.
"FRAUD_BLOCK" - Blocked (inactive) due to fraud, cannot set PIN, reissue card, or activate card through the /condor/card/activate endpoint.
"CLOSED" - closed, card status can no longer be changed. Card cannot be reactivated or reissued.

Required Properties	Description	Schema	Example Values
cardId	The card ID in connectFi	String	"crda_fO2N93TnJZvSmUgFFClUA"
statusAction	The requested status	String	"ACTIVE", "BLOCK", "FRAUD_BLOCK", or "CLOSED"

Optional Properties	Description	Schema	Example Values
reason	The reason why the card status is being changed, nullable	String	"Test space"

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_fO2N93TnJZvSmUgFFClUA", //card ID in connectFi
    "statusAction": "FRAUD_BLOCK", //desired status
    "reason" : "Test space" //reason why the status change is being requested, optional
}

Successful Response Example

200 (HTTP response status code) -- Success, the status of the card was changed

{
    "code": "0", //Success
    "data": {
        "cardChangeStatus": {
            "last_four": "####", //last 4 digits on the card, #### is used as a placeholder here for documentation purposes
            "status": "FRAUD_BLOCK", //updated status after request succeeded
            "program_id": "Virtual_Debit_Card",
            "name_on_card": "JESSIE U TESTMAN 2",
            "available_balance": 0, //amount that has been loaded onto the card
            "currency_code": "USD",
            "additional_data": {
                "account_number": "##############", //customer account number associated with the card, ############## is used as  a placeholder for documentation purposes
                "issue_date": "2022-10-25T18:08:32.985266Z", //date the card was issued
                "activation_date": "2022-10-26T17:30:30.261288Z", //date the card was activated
                "design_id": "1",
                "designId": "1",
                "card_expiration": "102025", //card expiration date MMYYYY
                "processor_token": "369029826861",
                "routing_number": "#########" //a US ABA account routing number, ######### is used as a placeholder here for documentation purposes
            },
            "cardId": "crda_fO2N93TnJZvSmUgFFClUA" //card ID in connectFi
        }
    }
}

Errors

400 (HTTP response status code) -- Set Card Status Decline

In this example, a request to change a "NEW" card to status code "BLOCK" was attempted. You may use this endpoint to change a "NEW" card to status code "FRAUD_BLOCK", "CLOSED", or "ACTIVE".

{
    "code": "extCondor",
    "subCode": "C1014",
    "context": {
        "title": "cardsUpdateStatusByToken"
    },
    "message": "Set Card Status Decline (Changing card status from existing status to status (Inactive) is not allowed))"
}

400 (HTTP response status code) -- Status action must be equal to one of the allowed values

In this example, an invalid statusAction was requested.

{
    "code": "requestValidateError",
    "context": [
        {
            "instancePath": "/statusAction",
            "schemaPath": "#/properties/statusAction/enum",
            "keyword": "enum",
            "params": {
                "allowedValues": [
                    "ACTIVE",
                    "BLOCK",
                    "FRAUD_BLOCK",
                    "CLOSED"
                ]
            },
            "message": "must be equal to one of the allowed values"
        }
    ]
}