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.