Error Codes

Validation Errors

📘

These error codes are currently being returned only on Credit Transfer Instruction Endpoint

Official ISO 20022 ExternalStatusReason1Code values are used as error codes (see the full list here).

The same error code may be used for different scenarios, but every error will include a specific description as well.

Error CodeDescriptionScenarios
AC01Account number is invalid or missing
AC02Debtor account number invalid or missing
  • Debtor account number invalid or missing.
  • Debtor virtual account number invalid or missing.
  • Provided debtor account number is ambiguous, use IBAN instead.
AC03Creditor account number invalid or missing
AC05Debtor account is closed or inactive
AG08Insufficient permissions for payment instruction
AM01Amount zero is not allowed
AM02Amount exceeds agreed limit
AM03Amount currency mismatch
  • Amount currency must match either debtor account currency or transfer currency
AM06Amount below minimum allowed value
AM11Currency missing or invalid
AM12Amount is not valid
  • Invalid length
  • Invalid format
BE04Creditor address missing or invalid
BE07Debtor address missing or invalid
BE09Country code missing or invalid
BE11Country code mismatch
  • Invalid IBAN + country code combination
  • Forbidden transfer to country
BE19Charge bearer code missing or invalid
BE20Name length exceeds limitation
BE21Name missing or invalid
CH03Requested execution date is too far in the future
CH04Requested execution date is in the past
CH16Content is incorrect
  • Field contains invalid characters
  • Field value exceeds min/max allowed length
CH20Number of amount decimals not supported by amount currency
DT01Invalid date
DUPLPayment is a duplicate of another payment
  • Idempotency key was already used by a different request
FF02Syntax error
  • Idempotency Key must be between 1 and 100 characters
FF04Service Level code is missing or invalid
FF06Category Purpose code is missing or invalid
FF07Purpose code is missing or invalid
FF08EndToEndId missing or invalid
RC01Invalid BIC/clearing code format
RC05BIC missing or invalid
RC07Financial institution missing or invalid
RC08NCC missing or invalid
RR07Remittance information missing or invalid
MINFMandatory field cannot be empty
NARRNarrativeAn error with no direct ExternalStatusReason1Code match.

Bulk Payments

Rejection codes

The table below shows the rejection which will trigger a rejection for the whole bulk file. For payment specific failures, refer to Rejected and returned payments reason codes.

CodeDescription
AmbiguousDebtorAccountProvided debtor account number is ambiguous, use IBAN instead.
BulkPaymentApproveDeclinePermissionViolationApproval required but no approvers exist.
CannotStoreDataCannot store data
ConflictingConfigurationTargeted debtor accounts have conflicting configuration.
DuplicateFileUploadThe file content uploaded has already been uploaded in a previous request
DuplicateIdempotencyKeyDuplicate Idempotency Key has been detected
InvalidAccountFormatUnsupported account format.
InvalidAmountFormatAmount not formatted correctly.
InvalidAmountLengthNumber of characters exceeds maximum allowed length
InvalidAmountPrecisionForCurrencyNumber of amount decimals not supported by amount currency.
InvalidCharactersInvalid characters used
InvalidChargeBearerUnsupported charge bearer.
InvalidContentTypeContent Type is not supported.
InvalidCsvFileExtensionUnsupported file extension.
InvalidCsvFileSizeFile size exceeds allowed maximum.
InvalidCsvMaximumNumberOfLinesNumber of lines (payments) above maximum allowed.
InvalidCsvMinimumNumberOfLinesNumber of lines (payments) below minimum allowed.
InvalidCurrencyUnsupported or invalid currency.
InvalidDateFormatDate format not supported.
InvalidDebtorAccountYou do not have permission to access selected debtor account or debtor account does not exist.
InvalidFileThe file contains errors in content as well as the file parameter itself
InvalidIdempotencyKeyIdempotency Key exceeds the 100 character limitation
InvalidLengthNumber of characters exceeds maximum allowed length.
InvalidMessageReferenceLengthMessageReference header exceeds the 35 character limitation
InvalidOrMissingTotpVerificationNonceTOTP verification nonce was invalid or missing for payment requiring TOTP verification.
MissingChargeBearerMissing charge bearer.
ProcessingErrorError processing the payment

Example of CSV file content

123456789,DK1111000000010011,015,DKK,20,DKK,10012022,A,Financial Inst.Ltd.,DK1111000000010100,S,SXPYDKKKXXX,,MESSAGE,,,,SHA,,,DKK,hello1234567,45  
BOD,SOMETHING,FR - GRENOBLE 38100,N  
123456789,DK1111000000010100,010,DKK,20,DKK,10012022,A,Financial  
Inst.  
Ltd.,DK1111000000010011,S,SXPYDKKKXXX,,MESSAGE,,,,SHA,,,DKK,hello1234568,45  
BOD,SOMETHING,FR - GRENOBLE 38100,N

Allowed characters

a b c d e f g h i j k l m n o p q r s t u v w x y z

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z

0 1 2 3 4 5 6 7 8 9

/ - ? : ( ) . , ' + _

Space

Note that the following characters are not allowed:

  • Field only composed of blank characters (space)
  • First character is colon (:) or hyphen (–)