Skip to content

Common Errors

Common Errors are errors that are common across all modules which require action on your part to resolve.

Error Code Label Description Context Status
badTimeFrameRequest The time frame entered is too broad. Please shorten the time frame. - 400
cardNotFound Card not found Check the card ID to make sure it is valid and exists.
Context:
cFiCardId - card ID in connectFi		 
{
  "cFiCardId": "chk_6KqfrvIYBk8KKUL4hMeUy7"
}
 400
currencyNotSupported Currency not supported. Need to enter a valid, supported currency.
Context:
supportedCurrency - A string containing supported currency(ies) for this request may be present		 
{
  "supportedCurrency": "USD"
}
 400
greaterMaximumNumberOfRecords The response contains more entries than allowed. Need to change the filter or set maxNumberOfRecords.
Context:
maxNumberOfRecords - Maximum number of records		 
{
  "maxNumberOfRecords": 0
}
 400
greaterNumberOfRecords The numberOfRecords field is greater than the request limit Need to reduce the numberOfRecords requested.
Context:
maxNumberOfRecords - Maximum number of records		 
{
  "maxNumberOfRecords": 1000
}
 400
referenceExists Reference already exists. Please enter a unique reference ID.
Context:
reference - The external reference ID in your system
entityId - The id in connectFi		 
{
  "reference": "DuplicateReferenceId123",
  "entityId": "entityId"
}
 400
transactionNotFound Transaction not found. Check the transaction ID to make sure it is valid and exists.
Context:
cFiTransactionId - A transaction in connectFi		 
{
  "cFiTransactionId": "entity_123456789abcdefghi1234"
}
 400
transactionQuery Transaction filter cannot have both references and cFiTransactionIds Please use either the references property or the cFiTransactions property, but not both. - 400
transactionReference Entered reference exists for a different transaction. Please enter a unique reference ID.
Context:
reference - The external reference ID in your system
status - The current status of the transaction matching this reference ID
cFiAggregatorId - A cFiAggregatorId in connectFi
cFiTransactionId - The transaction ID in connectFi matching this reference ID
amount - The amount of the existing transaction with the requested reference ID		 
{
  "reference": "DuplicateReferenceId123",
  "status": "Complete",
  "cFiAggregatorId": "entityName",
  "cFiTransactionId": "entity_123456789abcdefghi1234",
  "amount": 10
}
 400

Multi-Service Errors

Multi-Service Errors are errors that occur in one or more specific solutions, but are not common across all solutions. These errors require action on your part to resolve.

Errors relevant to individual services can be found in the specific service documentation. Note that this is not a comprehensive list of all possible errors. Rather, these errors represent issues that could cause multiple requests to fail unless addressed.

Error Code Label Description Context Status
requestValidateError Validation errors A validation error occurred.
Please enter a valid request body.
Context:
keyword - A keyword describing the type of validation error
instancePath - JSON Pointer to the location in the data instance
schemaPath - JSON Pointer to the location of the failing keyword in the schema
params - The parameters that failed validation
message - the error message		 
{
  "keyword": "required",
  "instancePath": "",
  "schemaPath": "#/required",
  "params": {
    "missingProperty": "cFiCardId"
  },
  "message": "must have required property 'cFiCardId'"
}
 400
unauthorized Unauthorized Unauthorized. - 401
moduleDisabled The module is disabled The module is disabled. - 400
uniqueAttributeNotFound The module is disabled You try to use the unknown module attributes - 400

General Errors

Error Code Label Description Context Status
businessCustomerFieldMissing A field required for business customers is missing. Please include the missing required field.
Context:
missingField - the missing required field		 
{
  "missingField": "businessInfo"
}
 400
customerExists Customer exists. This customer already exists in the system.
Context:
cFiAggregatorId - A cFiAggregatorId in connectFi
customerId - A customer ID in connectFi		 
{
  "cFiAggregatorId": "entityName",
  "customerId": "cstap_123456789abcdefghi1234"
}
 400
customerNotFound Customer not found. Check the customer ID to make sure it is valid and exists.
Context:
customerId - A customerId in connectFi		 
{
  "customerId": "cstap_123456789abcdefghi1234"
}
 400
busRepNotFound Business Representative not found. Check the customer ID and entity (business representative) ID to make sure they are valid and exist.
Context:
customerId - A customerId in connectFi
entityId - A business representative ID in connectFi		 
{
  "customerId": "cstab_123456789abcdefghi1234",
  "entityId": "cstab_123456789abcdefghi5678"
}
 400
customerType Customer type is not supported for this action. This action is restricted by customer type.
Current customer type is not supported for this action.
Context:
customerId - A customerId in connectFi
customerType - The type of customer in connectFi		 
{
  "customerId": "cstab_123456789abcdefghi1234",
  "customerType": "business"
}
 400
customerUpdateStatus Customers can only be updated if KYC status is empty or APPROVED. Customers can only be updated if KYC status is empty or APPROVED.
Context:
customerId - A customer ID in connectFi
kycStatus - Current customer KYC Status		 
{
  "customerId": "cstap_123456789abcdefghi1234",
  "kycStatus": "WAITING_DATA"
}
 400
customerUpdateFieldInvalid An invalid field for this customer type is present. An invalid field for this customer type is present.
Context:
field - The invalid field that is present in the request
customerId - A customer ID in connectFi
customerType - The customer type		 
{
  "field": "email",
  "customerId": "cstab_123456789abcdefghi1234",
  "customerType": "business"
}
 400
kycAlreadyInitiated KYC/KYB identification already initiated for this customer. KYC/KYB identification is already in process and cannot be reinitiated.
Context:
customerId - A customerId in connectFi		 
{
  "customerId": "cstap_123456789abcdefghi1234"
}
 400
fileNotFound File not found. File not found. - 400
ibisApplicationCreditWasGiven Credit was given by previous application. Must create new credit application to issue additional credit.
Context:
applicationId - The application ID in connectFi
creditId - The previous credit ID
creditBois - The back office that issued credit		 
{
  "applicationId": "exgsa_123456789abcdefghi1234",
  "creditId": "",
  "creditBois": ""
}
 400
ibisApplicationCreditLimit Credit limit in application is less than the requested credit limit. Requested credit limit must be less than or equal to the approved credit limit in the application.
Context:
applicationId - The application ID in connectFi		 
{
  "applicationId": "exgsa_123456789abcdefghi1234",
  "creditLimit": 0
}
 400
ibisApplicationCurrencyMismatch Currency in application does not match. Currency in application does not match.
Context:
applicationId - The application ID in connectFi
currency - The currency listed in the application		 
{
  "applicationId": "exgsa_123456789abcdefghi1234",
  "creditLimitCurrency": "USD"
}
 400
ibisApplicationIdMismatch The customerId does not match the customerId on the application. Check the customer ID and application ID to make sure they are a valid match.
Context:
customerId - The customer ID in connectFi
applicationId - The application ID in connectFi		 
{
  "customerId": "cstap_123456789abcdefghi1234",
  "applicationId": "exgsa_123456789abcdefghi1234"
}
 400
ibisApplicationIsNotApproved Application is not APPROVED. Application must be APPROVED to perform this action.
Context:
applicationId - The application ID in connectFi		 
{
  "applicationId": "exgsa_123456789abcdefghi1234"
}
 400
ibisApplicationNotFound Credit application not found. Credit application not found.
Context:
applicationId - The application ID in connectFi		 
{
  "applicationId": "exgsa_123456789abcdefghi1234"
}
 400
ibisCardHolderIdMismatch The cardHolderId must equal customerId for an individual customer. Check the cardHolderId and customerId for this request to ensure a valid match.
Context:
customerId - The customer ID in connectFi
cardHolderId - The card holder ID		 
{
  "customerId": "cstap_123456789abcdefghi1234",
  "cardHolderId": "cstap_123456789abcdefghi2345"
}
 400
ibisCardholderNotFound Cardholder not found on this customer. Check the cardHolderId to make sure it is valid and exists.
Context:
customerId - The customer ID in connectFi
cardHolderId - The card holder ID		 
{
  "customerId": "cstap_123456789abcdefghi1234",
  "cardHolderId": "cstap_123456789abcdefghi2345"
}
 400
ibisCardholderDisabled Cardholder is disabled. This action is not permitted. The requested cardholder has been disabled.
Context:
cardHolderId - The card holder ID		 
{
  "cardHolderId": "cstap_123456789abcdefghi2345"
}
 400
requiredDataNotFound Information required for this action was not found. Update the missing required information before performing this action.
Context:
entityId - The ID of the entity for which information was not found
missingData - A description of the required information not found for this entity		 
{
  "entityId": "cstap_123456789abcdefghi1234",
  "missingData": "PRIMARY address not found"
}
 400
rppsNoEncryptedPAN An unencrypted PAN was detected. An unencrypted PAN was detected. PANs must be encrypted. - 400
transactionNotSupported The requested transaction type is not supported by this endpoint. Check to make sure the requested type is on the list of supported transaction types.
Context:
transactionTypes - a list of supported transaction types for this endpoint		 
{
  "transactionTypes": [
    "ach",
    "push",
    "pull",
    "wire"
  ]
}
 400