---
title: Request and response codes: Cards
slug: apis/cards/request-and-response-codes-cards
description: Understand HTTP status codes used in Cross River's card APIs, including transaction codes, flags, card state and status, order status, instrument type and processing codes.
docTags:
createdAt: 2024-08-15T13:44:36.025Z
---
## Transaction Codes
This table gives all the allowed values for the `transaction code` field in the transaction endpoint
| Code |
| ----------------------------- |
| Incoming ACH |
| Incoming ACH Return |
| Incoming ACH NOC |
| Incoming ACH On-Us |
| Outgoing ACH |
| Outgoing ACH Return |
| Outgoing ACH NOC |
| Account Transfer |
| Fee |
| Fee Refund |
| Deposit |
| Withdrawal |
| Interest |
| Interest Reversal |
| Misc Credit |
| Misc Debit |
| Incoming Wire |
| Outgoing Wire |
| Check |
| Cash |
| Reversal |
| Adjustment |
| Sale |
| Card Auth |
| Payment |
| Refund |
| ATM Transaction |
| RTP Debit |
| RTP Credit |
| xPay Debit |
| xPay Credit |
| Withholding |
| Sweep Interest |
| Chargeback |
| Bonus |
| Reward |
| Card Pull |
| Card Push |
| Card Settlement |
| Crypto Purchase |
| Crypto Sale |
| Crypto Outgoing |
| Crypto Incoming |
| Crypto Transfer |
| Crypto Return |
| INTL (International) Outgoing |
| INTL (International) Return |
| Interchange |
## Flags
This table gives all the allowed values for the `flags `field in the transaction endpoint
| Code | Flag Description |
| ---- | ------------------------- |
| FRC | Force Post |
| NSF | Override Sufficient Funds |
| RES | Override Restrictions |
| STP | Override Stop Payments |
| PRE | Presettlement |
| PST | PostSettlement |
| STS | Override Account Status |
| RGD | Override RegD Policy |
| AUTH | Authorize Only |
| PRI | Priority |
| MPB | Memo Post Balance |
| TDP | Override Time Deposit |
| ZBP | Zero Balance Posting |
## Card state and status
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** |
## Card category
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 |
## Card status
In response to many card issuing calls, the `status` field indicates the activation status of the card.
## Card status reason
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 | |
## Order status
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` | |
## Instrument type
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 |
## Processing code
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 |
## Transaction message type
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 |
## Transaction response code
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 |