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. undefined 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.
undefined 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. undefined 401
moduleDisabled The module is disabled The module is disabled. undefined 400
uniqueAttributeNotFound The module is disabled You try to use the unknown module attributes undefined 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. undefined 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.
undefined 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