Skip to content

Errors Documentation

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 specific to individual services will follow the Multi-Service errors descriptions. 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

ACH Service Critical Errors

Error Code Label Description Context Status
achAttributes Aggregator doesn't have achAttributes. Contact support to request achAttributes.
Context:
cFiAggregatorId - A cFiAggregatorId in connectFi		 
{
  "cFiAggregatorId": "entityName"
}
 404
achEffectiveEntryDate Invalid effectiveEntryDate. Same day transfers must be received prior to 9:30am CST M-F. Next day transfers must be received prior to 7:30pm CST M-F. The entered date is not valid for an ACH transfer.
Same day transfers must be received prior to 9:30am CST M-F. Next day transfers must be received prior to 7:30pm CST M-F.
Otherwise, enter a future effective entry date.
Context:
effectiveEntryDate - The requested effective entry date		 
{
  "effectiveEntryDate": "YYYY-MM-DD"
}
 400
achVerify ACH Request Validation Error ACH Request Validation Error - 400
achValidate ACH Files Validation Error ACH Files Validation Error - 400
returnRateNotFound Return rate data not found for requested date and cFiAggregatorId. If return rate data is expected, please retry the request after sufficient time has passed for the return rate data to have been received and processed for this date.
Context:
cFiAggregatorId - A cFiAggregatorId in connectFi		 
{
  "cFiAggregatorId": "entityName",
  "date": "YYYY-MM-DD"
}
 400
wrongAmount ACH wrong amount Available values - 1, 1.2, 1.22. Unavailable value - 1.225 - 400

Akepa KYC/KYB Service Critical Errors

Error Code Label Description Context Status
applicationNotFound Application not found. Check the ID to make sure it is valid and exists.
Context:
applicationId - A cFiApplicationRef in connectFi		 
{
  "applicationId": "exgsa_123456789abcdefghi1234"
}
 404
documentNotFound Document not found. Check the document ID to make sure it is valid and exists.
Context:
documentId - The ID of the document in connectFi		 
{
  "documentId": "doc_123456789abcdefghi1234"
}
 400
extAkepa External akepa error An error occurred in the akepa back office - 400
fileNotFound File not found. File not found. - 400
statusApplicationEntity Entity has status completed. Action cannot be completed. This entity already has a completed status. - 400

Check Printing Service Critical Errors

Error Code Label Description Context Status
checkFilter The check filter cannot have both references and cFiCheckIds. Please use either the references property or the cFiCheckIds property, but not both. - 400
checkFlagAsVoidError There was an issue flagging the check entity as voided in the database. Contact support regarding this void request. An error occurred when flagging this check to be voided.
Context:
cFiCheckId - A check ID in connectFi		 
{
  "cFiCheckId": "chk_123456789abcdefghi1234"
}
 500
checkSettlementAccountForCheckPrint Aggregator doesn't have settlementAccountForCheckPrint attribute. Contact support to request settlementAccountForCheckPrint attribute.
Context:
cFiAggregatorId - An aggregator ID in connectFi		 
{
  "cFiAggregatorId": "entityName"
}
 400
cannotVoidError Сan not void. Checks can only be voided when in statuses Sent, InBank, Complete, Processing.
Context:
cFiCheckStatus		 
{
  "cFiCheckStatus": "Processing"
}
 400
checkNotFound Check not found. Check the check ID to make sure it is valid and exists.
Context:
cFiCheckId - a check ID in connectFi		 
{
  "cFiCheckId": "chk_6KqfrvIYBk8KKUL4hMeUy7"
}
 400
duplicateVoidError Request to void or cancel check has already been initiated. Duplicate void request was attempted.
Context:
cFiCheckId - a check ID in connectFi
cFiCheckStatus - current check status
cFiVoidStatus - current void status		 
{
  "cFiCheckId": "chk_6KqfrvIYBk8KKUL4hMeUy7",
  "cFiCheckStatus": "Sent",
  "cFiVoidStatus": "Processing"
}
 400

Ibis Card Services Errors

Error Code Label Description Context Status
ibisAllocatedCreditLimit Set allocatedCreditLimit if and only if the card type is credit. The allocatedCreditLimit attribute is required for credit cards, but should not be present for debit cards.
Context:
reference - The external reference ID in your system
cardtype - The type of card		 
{
  "reference": "ExtRefId12",
  "cardtype": "credit"
}
 400
ibisCannotReverseError Unable to reverse this transaction. Reversals are currently only supported for card-to-card transactions.
The reversal amount must be less than or equal to the transaction amount.
Context:
fundsContext - An object identifying the transaction		 
{
  "fundsContext": {}
}
 400
ibisCardExpirationFormat The cardExpDate format is invalid. The cardExpDate attribute needs MMYY date format. - 400
ibisProgramIdClosed The requested card or account program is closed for opening new cards/accounts. Please use a valid, active card or account program ID.
Context:
programId - The requested card/account program		 
{
  "programId": "ClosedProgramId"
}
 400
ibisProgramNotSupported The requested card or account program is not supported for this customer. Please use a valid, active card or account program ID.
Context:
programId - The requested card/account program
customerType - The customer type		 
{
  "programId": "NonSupportedProgramId",
  "customerType": "customerType"
}
 400
ibisCardStatusError Card has an error status. Contact support regarding the status of this card.
Context:
cFiCardId - The card ID in connectFi
reference - The external reference ID in your system
error - Error message		 
{
  "cFiCardId": "icrd_123456789abcdefghi1234",
  "reference": "ExtRefId123",
  "error": {
    "code": "",
    "message": "",
    "boTransId": ""
  }
}
 400
ibisFundsTransferNotFound Funds transfer not found. Check the funds transfer ID to make sure it is valid and exists.
Context:
fundsId - The cFiFundsId, reference ID, or arn for the transfer		 
{
  "fundsId": "ifnd_123456789abcdefghi1234"
}
 400
ibisSettlementIdNotFound Aggregator doesn't have ibisSettlementId attribute. Contact support to request ibisSettlementId attribute.
Contact support to request ibisSettlementId attribute.
Context:
cFiAggregatorId - A cFiAggregatorId in connectFi		 
{
  "cFiAggregatorId": "entityName"
}
 400
ibisCheckPinCardLocked CheckPinCard method is locked You have exceeded the maximum failed number of attempts to check the card PIN
Context:
cFiCardId - The card ID in connectFi
maxAttempts - Maximum failed number of attempts to check
until - Unlock time		 
{
  "cFiCardId": "icrd_123456789abcdefghi1234",
  "maxAttempts": 3,
  "until": "2023-06-29T07:12:08.965Z"
}
 400
ibisVAccountOnly Action not allowed for vAccount only accounts. This action is restricted to card accounts.
Context:
id - The account ID in connectFi		 
{
  "id": "icrd_123456789abcdefghi1234"
}
 400
ibisReissueError Reissue with same card number not allowed when reasonCode is Lost/Stolen [3] or Fraud/Compromised [4]. Reissue with same card number not allowed when reasonCode is Lost/Stolen [3] or Fraud/Compromised [4].
Context:
reasonCode - The reasonCode for the reissue attempt		 
{
  "reasonCode": "4"
}
 400
ibisSecondaryCardsNotSupported Secondary cards not supported for this card program. Secondary cards not supported for this card program.
Context:
programId - The requested card/account program		 
{
  "programId": "NonSupportedProgramId"
}
 400
ibisActionNotAllowed The requested action is not allowed. The requested action is not allowed. - 400
ibisCustomerIdPrimaryCardMismatch The customerId must equal customerId for the primary card. Check the primary card customerId and customerId for this request to ensure a valid match.
Context:
customerId - The customer ID in connectFi that was entered in the request		 
{
  "customerId": "cstap_123456789abcdefghi1234"
}
 400
extIbis External ibis error An error occurred in the ibis back office. - 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

RPPS Bill Payment Services Errors

Error Code Label Description Context Status
billNotFound Bill not found. Check the transaction ID to make sure it is valid and exists.
Context:
cFiTransactionId - The transaction ID in connectFi		 
{
  "cFiTransactionId": "amplifi_6Gzh1tFquVCAKof441jLsm"
}
 400
rppsBillerNotFound Biller was not found or has been archived. Check the biller ID to make sure it is valid and exists.
If the biller ID exists in the billers list, but has been archived, then the biller is not currently active to accept RPPS bill payments.
Context:
billerId - The biller ID		 
{
  "billerId": ""
}
 400
rppsAccountNumber Need to send only one of accountNumber or accountNumberEncrypted. Use accountNumber or accountNumberEncrypted but not both. - 400
rppsAccountNumberEncrypted The account number for this account must be encrypted. The account number for this account must be encrypted. - 400
rppsBillStatus This transaction does not have a valid status for the requested action. This transaction does not have a valid status for the requested action.
Context:
cFiTransactionId - The transaction ID in connectFi
cFiAggregatorId - The cFiAggregatorId in connectFi
entityStatus - The current transaction status		 
{
  "cFiTransactionId": "entity_123456789abcdefghi1234",
  "cFiAggregatorId": "entityName",
  "entityStatus": "Processing"
}
 400
rppsDecryptAccountNumber Unable to decrypt accountNumberEncrypted. Check to make sure that the public keys used to encrypt this account number are current and consistent with the instance used. - 400
rppsIsReversal User does not have access for bill reversal. This user is not authorized to reverse bill payment transactions. - 401
rppsMaskMatch Biller mask match error. Check the masks array to ensure that the account number mask used is valid for this biller.
Context:
billerId - The biller ID,
masks - An array of the account number masks accepted by this biller		 
{
  "billerId": "1234567890",
  "masks": [
    {
      "recordType": "",
      "mask_key": "",
      "record_effective_date": "",
      "mask_length": "",
      "mask": "",
      "exception_mask": ""
    }
  ]
}
 400
rppsNoEncryptedPAN An unencrypted PAN was detected. An unencrypted PAN was detected. PANs must be encrypted. - 400

Toucan Push/Pull to Card Services Errors

Error Code Label Description Context Status
toucanCannotReverseError Unable to reverse this transaction. Reversals are only available for pull transactions that are in a Pending or Completed status.
Context:
cFiTransactionId - The transaction ID in connectFi		 
{
  "cFiTransactionId": "tcrd_123456789abcdefghi1234"
}
 400
toucanPullNotAllowed Pull transactions are not allowed for this card. Pull transactions are not allowed for this card.
Context:
cardId - A card ID in connectFi		 
{
  "cardId": "tcrd_123456789abcdefghi1234"
}
 400
toucanPushNotAllowed Push transactions are not allowed for this card. Push transactions are not allowed for this card.
Context:
cardId - A card ID in connectFi		 
{
  "cardId": "tcrd_123456789abcdefghi1234"
}
 400
toucanSettlementAccountNotFound Aggregator doesn't have toucanSettlementAccount attribute. Contact support to request toucanSettlementAccount attribute.
Context:
cFiAggregatorId - A cFiAggregatorId in connectFi		 
{
  "cFiAggregatorId": "entityName"
}
 400
toucanTransactionMethodsNotAllowed Push and pull transactions are not allowed for this card. Push and pull transactions are not allowed for this card. - 400

Wire Services Errors

Error Code Label Description Context Status
extWire External wire error. An error occurred in the wires back office. - 400
wireAmountDailyLimit The daily amount limit for wires has been exceeded. Occurs when the monetary amount limit has been exceeded.
If higher monetary amounts of wires are expected, speak to your PayGears representative.
Context:
reference - The external reference in your system
status - The current status of this request
cFiAggregatorId - A cFiAggregatorId in connectFi
cFiTransactionId - A transaction ID in connectFi
amount - The wire amount
dtsError - Additional error information		 
{
  "reference": "",
  "status": "",
  "cFiAggregatorId": "",
  "cFiTransactionId": "",
  "amount": 0,
  "dtsError": ""
}
 400
wireRequestsDailyLimit The wires request limit has been exceeded. Occurs when the number of wire requests allowed limit has been exceeded.
If higher volumes of wire requests are expected, speak to your PayGears representative.
Context:
reference - The external reference in your system
status - The current status of this request
cFiAggregatorId - A cFiAggregatorId in connectFi
cFiTransactionId - A transaction ID in connectFi
amount - The wire amount
dtsError - Additional error information		 
{
  "reference": "",
  "status": "",
  "cFiAggregatorId": "",
  "cFiTransactionId": "",
  "amount": 0,
  "dtsError": ""
}
 400
wireMerchantIdNotFound Aggregator doesn't have Wires merchantId attribute. Contact support to request merchantId attribute.
Context:
cFiAggregatorId - A cFiAggregatorId in connectFi		 
{
  "cFiAggregatorId": "entityName"
}
 400
wireTransactionNotFound Wire transaction not found. Check the transaction ID to make sure it is valid and exists.
Context:
cFiTransactionId - A transaction ID in connectFi		 
{
  "cFiTransactionId": "entity_123456789abcdefghi1234"
}
 400
wireTransactionMissMatchingValues Wire transaction found with same reference but there are difference between request and existing transaction. Check the request body make sure that currency, amount and/or endUserAccountId is correct.
Context:
reference - A transaction reference		 
{
  "reference": "externalTrnId1234"
}
 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
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
kycNotInitialized KYC/KYB identification not found for this customer. Need to initiate customer KYC before performing this action. - 400
kycNotApproved KYC/KYB status not APPROVED. Need an APPROVED customer KYC status before performing this action. - 400
fileNotFound File not found. File not found. - 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
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