Card status
Card status refers to the current state or condition of a payment card. It indicates whether the card is active, inactive, blocked, expired, or in any other specific state.
Card status is crucial as it determines whether the card can be used for transactions, and can provide information about the card's eligibility for specific features or benefits.
Card status mapping
The following table lists all available card status, their description, and how these card status may impact a transaction response message.
- Where a client takes the final approve/decline decision, the
Processor_Decision_Codeis the suggested response code the client will receive in the FAST request message. - Where Paymentology takes the final approve/decline decision, the
Processor_Decision_Codeis used to respond to the network, below listed for each network separatly.
Processor_Decision_Code= Listed response codes for each network separatly below
Processor_Reason_Code= Reason code. You can find theProcessor_Reason_Codedescriptions here.
| Card status | Description | Reason code | Mastercard | Visa | *Mada | Jaywan | Cuscal | Bancnet | NEX |
|---|---|---|---|---|---|---|---|---|---|
| 1000 | Fully operational | 00 | Status is valid | Status is valid | Status is valid | Status is valid | Status is valid | Status is valid | Status is valid |
| 1001 | Refer to Issuer | 401 | 01 | 01 | 107 | 01 | 05 | 05 | 01 |
| 1004 | Capture card | 402 | 04 | 04 | 200 | 04 | 05 | 67 | 04 |
| 1005 | Decline all transactions | 400 | 05 | 12 | 100 | 05 | 05 | 05 | 05 |
| 1006 | Inactive - PIN blocked | 412 | 57 | 5C | 100 | 57 | 57 | 24 | 57 |
| 1007 | Inactive card - formal decline | 414 | 14 | 12 | 100 | 14 | 14 | 14 | 14 |
| 1008 | Honour with ID | 404 | 08 | 08 | 001 | 08 | 08 | 08 | 08 |
| 1009 | Void card - formal decline | 415 | 62 | 46 | 100 | 62 | 62 | 62 | 62 |
| 1010 | Blocked card - Past due statement | 417 | 62 | 62 | 119 | 62 | 62 | 62 | 62 |
| 1011 | Blocked card - Compliance hold | 418 | 62 | 62 | 119 | 62 | 62 | 62 | 62 |
| 1034 | Dynamic block by rule engine (PayRule) | Determined by the rule action | Determined by the rule action | ||||||
| 1041 | Lost card - capture | 405 | 41 | 41 | 208 | 41 | 41 | 67 | 41 |
| 1043 | Stolen card - capture | 406 | 43 | 43 | 209 | 43 | 43 | 67 | 43 |
| 1054 | Expired card - report | 407 | 54 | 54 | 101 | 54 | 54 | 54 | 54 |
| 1062 | Restricted card | 403 (MADA:410) | 62 | 62 | 104 | 62 | 62 | 62 | 62 |
| 1140 | Lost card - no capture | 408 | 05 | 05 | 100 | 05 | 05 | 05 | 05 |
| 1143 | Stolen card - no capture | 409 | 05 | 05 | 100 | 05 | 05 | 67 | 05 |
| 1154 | Expired card - don't inform | 410 | 05 | 54 | 100 | 05 | 05 | 05 | 05 |
| 1199 | Void card - once card status is set to void it can notchange. It means the card is completely closed. | 411 | 05 | 46 | 100 | 05 | 05 | 05 | 05 |
*Column only applicable to clients using Mada network.
Changing or updating a card status
Card status can be changed via the Set card status endpoint.
When using the Set Card Status endpoint, you can change the card status to any of the following:
Card status Status_nwk | Description |
|---|---|
| 1000 | Fully operational |
| 1001 | Refer to Issuer |
| 1004 | Capture card |
| 1005 | Decline all transactions |
| 1006 | Inactive - PIN blocked |
| 1007 | Inactive card - formal decline |
| 1008 | Honour with ID |
| 1009 | Void card - formal decline |
| 1041 | Lost card - capture |
| 1043 | Stolen card - capture |
| 1054 | Expired card - report |
| 1062 | Restricted card |
| 1154 | Expired card - don't inform |
| 1199 | Void card - once card status is set to void it can notchange. It means the card is completely closed. |
There are also certain conditions when a card status changes and transactions are blocked.
- When PIN attempts has successively failed three times the card status is set to 1006.
- When PIN verrification has successively failed four times via API the card status is set to 1006.
- PIN unblock.
In such cases, you can subscribe to receive Card Status Update (CSU) notifications indicating the reason for the card status change.
You can read more about CSU notifications here.
Updating linked tokens
When the Set Card Status endpoint is used to change the card status, Lume will automatically update the linked digital tokens.
- If
status_nwk=1000then all linked digital tokens will be unsuspended. - If
status_nwk=1199then all linked tokens will be deleted. - If
status_nwkis changed to anything other than1000or1199then all linked digital tokens will be suspended.
IMPORTANTAutomatically updating linked digital tokens is only applicable to clients using Paymentology tokenization services.
Dynamic blocking
Cards can be dynamically blocked, this allows cards to be blocked for a period of time. Upon expiry of the dynamic block, the card will revert to Card Status: 1000 Fully Operational.
You can check if a card has a dynamic block via the Get card status endpoint. When a card has a dynamic block the response message will include the expiry date of the block in the dynamic_block response field.
If there is no dynamic block for the card, or the previous dynamic block has expired, the response message returns an empty value in the dynamic_blockfield.
Removing an existing dynamic block:
Where you want to remove an existing dynamic block, use the Set card status endpoint and set the status_nwk field to 1000 Fully Operational.
Card status API endpoints
- Set card status: Used to change the status of a card. This version (version 2) supports idempotency and allows cardholders to continue transacting with their digital wallet (i.e. Apple Pay) whilst their card is suspended.
- Get card status: Used to retrieve the current card status.
- Unblock PIN: Used to unblock a PIN, where the PIN is blocked due to 3x failed PIN attempts.
- Verify PIN: Used to verify the PIN of the card.
Updated 19 days ago