Request and response codes
This table explains each card state and status. The status appears as a value in the status field of the response.
Card state | Card status | Other related fields and their values |
|---|---|---|
Card has never been Activated | Unactivated | |
Card Activated | Active | |
Card Closed | Closed | |
Card Lost | Suspended | StatusReasonCode = Lost |
Card Stolen | Suspended | StatusReasonCode = Stolen |
Admin Blocked | Suspended | AdminBlocked = true |
Fraud Blocked | Suspended | FraudSuspect = true StatusReasonCode = FraudBlocked |
Card Suspended by User | Suspended | StatusReasonCode = NotSet |
Card Unsuspended by User or Admin | Active | StatusReasonCode = NotSet FraudSuspect = false AdminBlocked = false |
In response to many card issuing calls, the category field indicates the card category.
Category | Description |
|---|---|
Debit | Debit card |
Credit | Credit card |
Prepaid | Prepaid card |
In response to many card issuing calls, the status field indicates the activation status of the card.
In response to many card issuing calls, the statusReasonCode field indicates the reason for the activation status supplied in the status field.
Reason | Description |
|---|---|
Not Set | |
Damaged | Card damaged |
Expired | Card expired |
Lost Stolen | Card reported lost or stolen |
Fraud Compromised | Card was compromised and closed because of fraud |
Return | |
New Enrollment | |
In response to many card issuing calls, the orderStatus field indicates the status of the card order.
Value | Status | Description |
|---|---|---|
0 | OrderPending | The order is pending fulfillment by the processor |
1 | Completed | The order has been fulfilled by the processor. For physical cards, the card is being printed and mailed to the cardholder. |
2 | Failed | The order failed at the processor |
3 | Authorizing | |
4 | AuthorizationFailed | |
5 | AuthorizationCompleted | |
In response to many card issuing calls, the paymentInstrument field indicates the type of card.
Type | Description |
|---|---|
Physical MSR | Physical card with a magnetic strip |
PhysicaI CC | Physical card with a chip |
Physical Contactless | Physical card using RFID |
Physical Combo | Physical card with a chip that supports contactless payments |
Virtual Pan | Virtual card |
In the response to GET /cardmanagement/v1/transactions, the processingCode field indicates what process took place for a given transaction.
Code | Definition |
|---|---|
00 | Purchase |
01 | Withdrawal |
02 | Debit Adjustment |
03 | Guarantee with Conversion (POS Check Service) (Future Use) |
04 | Verification with Conversion (POS Check Service) (Future Use) |
06 | Traveler Check |
09 | Purchase with Cash Back |
10 | Account Funding |
11 | Quasi-Cash Transaction–Debit or Internet Gambling Transaction |
13 | Funds Withdrawal for Electronic Purse |
17 | Cash Disbursement |
18 | Deferred Goods and Services/Scrip Issue/Conversion Only (POS Check Service) (Future Use) |
19 | Debit Fee Collection/Deferred Goods and Services With Cash Disbursement |
20 | Credit Return (of goods)/Credit Transaction/Credit Voucher or Merchandise/Return Authorization (U.S. Only)/Purchase Return/Refund |
21 | Deposit |
22 | Credit Adjustment |
23 | Check Deposit Guarantee |
24 | Check Deposit |
25 | Envelope-less Cash Deposit |
26 | Original Credit |
28 | Prepaid Activation and Load Prepaid Load/Payment Transaction |
29 | Credit Funds Disbursement/Primary Credit |
30 | Available Funds Inquiry/Commercial Deposit |
31 | Balance Inquiry |
33 | Account Updater Code/Account Verification (Future Use) |
34 | ATM Mini Statement |
49 | Eligibility Inquiry/Generic Balance Inquiry (Future Use) |
40 | Cardholder Account Transfer |
50 | Bill Payment/Payment to Another Party |
53 | Payment (U.S. only) |
54 | Payment Debit (P2P) |
55 | Payment from Third Party |
56 | Payment Credit (P2P) |
58 | Payment from Account to Credit/Loan |
59 | Payment Enclosed |
72 | Prepaid Activation |
91 | PIN Unblock |
92 | PIN Change |
In the response to GET /cardmanagement/v1/transactions, the messageType field indicates the message type related to the transaction
Type |
|---|
Authorization |
Authorization Advice |
Financial |
Financial Advice |
Reversal Request |
Network Management Request |
In the response to GET /cardmanagement/v1/transactions, the outboundResponseCode field indicates the outbound response code related to the transaction
Code | Definition |
|---|---|
00 | Approved |
01 | Refer to Card Issuer |
02 | Refer to Card Issuer Special Condition |
03 | Invalid Merchant |
04 | Lost or Stolen Card |
05 | Do not Honor |
06 | Error |
07 | Pickup Card, Special Condition |
08 | Honor with Identification |
10 | Approved Partial Amount |
12 | Invalid Transaction |
13 | Invalid Amount |
14 | Invalid Card Number |
15 | Invalid Issuer |
17 | Customer Cancellation Reversal |
27 | Issuer File Update Field Edit Error |
30 | Format Error |
31 | Bank Not Supported by Switch - Future Use |
32 | Partial Reversal |
33 | Expired Card Pickup |
34 | Suspect Fraud |
39 | No Credit Account - Future Use |
40 | Requested Function Not Supported |
41 | Lost Card Not Captured |
42 | No universal account |
43 | Stolen Card Pickup |
51 | Insufficient Funds |
52 | No Checking Account - Future Use |
53 | No Savings Account - Future Use |
54 | Expired Card |
55 | Invalid PIN |
56 | No Card Account |
57 | Transaction not Permitted to Cardholder |
58 | Transaction Not Permitted to Acquirer |
59 | Suspected Fraud |
61 | Exceeds Withdrawal Amount Limit |
62 | Restricted Card |
63 | Security Violation |
64 | Original Amount Incorrect Reversal |
65 | Exceeds Withdrawal Frequency Limit |
68 | Response Received Late |
70 | Invalid Transaction Contact Card Issuer |
71 | PIN Change Decline |
75 | Allowed Number of PIN Tries Exceeded |
76 | Invalid Nonexistent To Account Specified - Future Use |
77 | Invalid Nonexistent From Account Specified - Future Use |
78 | Invalid Nonexistent Account Specified General - Future Use |
79 | Key Exchange Validation Failed |
80 | System Not Available - Future Use |
81 | Invalid Transaction PIN Block Format Error |
82 | Time Out Issuer |
84 | Invalid Authorization LifeCycle |
85 | Approved Account Verification |
86 | PIN Validation Not Possible |
87 | Approved Purchase Only |
88 | Invalid Transaction CVV2 Format Error |
89 | Bad Expiry Date |
91 | Issuer Switch Inoperative |
92 | Route Unable Transaction |
93 | Transaction Cannot be Completed |
94 | Duplicate Transmission |
96 | System Error |
97 | Already Activated Card |
99 | Approve Transaction Super Green Path |
AT | Auth Host Timed Out |
CD | Cryptogram Decline |
CN | Invalid Currency |
DN | Auth Host Down |
E7 | Bad CVV2 Expiry Date |
GA | General AVS Decline |
GC | General Card Decline |
GV | General CVV2 Decline |
PA | Pre Active Card |
PF | Invalid Status Purse |
PI | PIN Change Fail Invalid Data |
PL | Bad PIN Invalid PIN Block Length |
SA | Inactive Card |
SD | Account Closed |
TM | Card Technology Mismatch |
1A | Strong Customer Authentication Required |
AI | ATC Validation Failed |
