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 Code

Description

Scenarios

AC01

Account number is invalid or missing

AC02

Debtor 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.

AC03

Creditor account number invalid or missing

AC05

Debtor account is closed or inactive

AG08

Insufficient permissions for payment instruction

AM01

Amount zero is not allowed

AM02

Amount exceeds agreed limit

AM03

Amount currency mismatch

  • Amount currency must match either debtor account currency or transfer currency

AM06

Amount below minimum allowed value

AM11

Currency missing or invalid

AM12

Amount is not valid

  • Invalid length
  • Invalid format

BE04

Creditor address missing or invalid

BE07

Debtor address missing or invalid

BE09

Country code missing or invalid

BE11

Country code mismatch

  • Invalid IBAN + country code combination
  • Forbidden transfer to country

BE19

Charge bearer code missing or invalid

BE20

Name length exceeds limitation

BE21

Name missing or invalid

CH03

Requested execution date is too far in the future

CH04

Requested execution date is in the past

CH16

Content is incorrect

  • Field contains invalid characters
  • Field value exceeds min/max allowed length

CH20

Number of amount decimals not supported by amount currency

DT01

Invalid date

DUPL

Payment is a duplicate of another payment

  • Idempotency key was already used by a different request

FF02

Syntax error

  • Idempotency Key must be between 1 and 100 characters

FF04

Service Level code is missing or invalid

FF06

Category Purpose code is missing or invalid

FF07

Purpose code is missing or invalid

FF08

EndToEndId missing or invalid

RC01

Invalid BIC/clearing code format

RC05

BIC missing or invalid

RC07

Financial institution missing or invalid

RC08

NCC missing or invalid

RR07

Remittance information missing or invalid

MINF

Mandatory field cannot be empty

NARR

Narrative

An 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 (–)