Treasury API Error Codes (InstaPay/PesoNet)

What are the errors related to the Treasury API?

PesoNet and InstaPay Error Codes

ISO 20022 Status codes implemented by both Pesonet and Instapay.

Error CodeCode ExplanationExplanationAction
AB01AbortedClearingTimeoutFailed transfer. Clearing was aborted.Transaction failed due to a system issue. Please retry again in a few hours. If the problem persists, contact [email protected] for assistance.
AB02AbortedClearingFatalError
AB03AbortedSettlementTimeout
AB04AbortedSettlementFatalError
AB05TimeoutCreditorAgent
AB06TimeoutInstructedAgent
AB07OfflineAgent
AB08OfflineCreditorAgentOther party's account server is offlineTransaction failed as the recipient’s bank is temporarily offline. Please try again later.
AB09ErrorCreditorAgent
AB10ErrorInstructedAgent
AC01IncorrectAccountNumberMerchant sent to an account number that doesn't existTransaction failed as the recipient's account number is invalid or does not exist. Please double-check the details and enter the correct account number before trying again.
AC02InvalidDebtorAccountNumber
AC03InvalidCreditorAccountNumberMerchant sent to an invalid account numberTransaction failed as the recipient account number is invalid. Please verify the account details and try again. If the problem persists, contact [email protected] for assistance.
AC04ClosedAccountNumberMerchant sent to a closed account numberTransaction failed as the recipient's account has been closed. Please verify the details, and try sending to an active recipient account.
AC05ClosedDebtorAccountNumber
AC06BlockedAccountMerchant sent to an account number that's blockedTransaction failed as the recipient account is currently blocked. Please verify the details, and try sending to an active recipient account.
AC07ClosedCreditorAccountNumber
AC08InvalidBranchCode
AC09InvalidAccountCurrency
AC10InvalidDebtorAccountCurrency
AC11InvalidCreditorAccountCurrency
AC12InvalidAccountType
AC13InvalidDebtorAccountType
AC14InvalidCreditorAccountType
AC15AccountDetailsChanged
AG01TransactionForbiddenEither the sender or receive is not allowed to receive the transferTransaction failed as this transfer is restricted. Please verify that the recipient's account can receive funds. If the issue persists, contact [email protected] for assistance.
AG02InvalidBankOperationCode
AG03TransactionNotSupported
AG04InvalidAgentCountry
AG05InvalidDebtorAgentCountry
AG06InvalidCreditorAgentCountry
AG07UnsuccesfulDirectDebit
AG08InvalidAccessRights
AG09PaymentNotReceived
AG10AgentSuspended
AG11CreditorAgentSuspended
AGNTIncorrectAgent
AM01ZeroAmount
AM02NotAllowedAmount
AM03NotAllowedCurrency
AM04InsufficientFundsSettlement account no fundsTransaction failed as your account does not have enough funds to complete this transaction. Please fund your account, and retry the transaction.
AM05DuplicationDuplicate transaction was madeTransaction failed as it looks like this transaction has already been processed. Please check your transaction history before trying again.
AM06TooLowAmount
AM07BlockedAmount
AM09WrongAmount
AM10InvalidControlSum
AM11InvalidTransactionCurrency
AM12InvalidAmount
AM13AmountExceedsClearingSystemLimit
AM14AmountExceedsAgreedLimitReceiving bank has limitationsTransaction failed as the recipient's account has reached its receiving limit. If the issue persists, please contact PayMongo support at [email protected] for assistance.
AM15AmountBelowClearingSystemMinimum
AM16InvalidGroupControlSum
AM17InvalidPaymentInfoControlSum
AM18InvalidNumberOfTransactions
AM19InvalidGroupNumberOfTransactions
AM20InvalidPaymentInfoNumberOfTransactions
AM21LimitExceeded
AM22ZeroAmountNotApplied
AM23AmountExceedsSettlementLimit
BE01InconsistenWithEndCustomer
BE04MissingCreditorAddress
BE05UnrecognisedInitiatingParty
BE06UnknownEndCustomer
BE07MissingDebtorAddress
BE08MissingDebtorName
BE09InvalidCountry
BE10InvalidDebtorCountry
BE11InvalidCreditorCountry
BE12InvalidCountryOfResidence
BE13InvalidDebtorCountryOfResidence
BE14InvalidCreditorCountryOfResidence
BE15InvalidIdentificationCode
BE16InvalidDebtorIdentificationCode
BE17InvalidCreditorIdentificationCode
BE18InvalidContactDetails
BE19InvalidChargeBearerCode
BE20InvalidNameLength
BE21MissingName
BE22MissingCreditorName
CERICheckERI
CH03RequestedExecutionDateOrRequestedCollectionDateTooFarInFuture
CH04RequestedExecutionDateOrRequestedCollectionDateTooFarInPast
CH07ElementIsNotToBeUsedAtB-andC-Level
CH09MandateChangesNotAllowed
CH10InformationOnMandateChangesMissing
CH11CreditorIdentifierIncorrect
CH12CreditorIdentifierNotUnambiguouslyAtTransaction-Level
CH13OriginalDebtorAccountIsNotToBeUsed
CH14OriginalDebtorAgentIsNotToBeUsed
CH15ElementContentIncludesMoreThan140Characters
CH16ElementContentFormallyIncorrect
CH17ElementNotAdmitted
CH19ValuesWillBeSetToNextTARGETday
CH20DecimalPointsNotCompatibleWithCurrency
CH21RequiredCompulsoryElementMissing
CH22COREandB2BwithinOnemessage
CNORCreditor bank is not registered
CURRIncorrectCurrency
CUSTRequestedByCustomer
DNORDebtor bank is not registeredbank is not registeredTransaction failed as the recipient bank is not registered. Please try another bank.
DS01ElectronicSignaturesCorrect
DS02OrderCancelled
DS03OrderNotCancelled
DS04OrderRejected
DS05OrderForwardedForPostprocessing
DS06TransferOrder
DS07ProcessingOK
DS08DecompressionError
DS09DecryptionError
DS0ADataSignRequested
DS0BUnknownDataSignFormat
DS0CSignerCertificateRevoked
DS0DSignerCertificateNotValid
DS0EIncorrectSignerCertificate
DS0FSignerCertificationAuthoritySignerNotValid
DS0GNotAllowedPayment
DS0HNotAllowedAccount
DS0KNotAllowedNumberOfTransaction
DS10Signer1CertificateRevoked
DS11Signer1CertificateNotValid
DS12IncorrectSigner1Certificate
DS13SignerCertificationAuthoritySigner1NotValid
DS14UserDoesNotExist
DS15IdenticalSignatureFound
DS16PublicKeyVersionIncorrect
DS17DifferentOrderDataInSignatures
DS18RepeatOrder
DS19ElectronicSignatureRightsInsufficient
DS20Signer2CertificateRevoked
DS21Signer2CertificateNotValid
DS22IncorrectSigner2Certificate
DS23SignerCertificationAuthoritySigner2NotValid
DS24WaitingTimeExpiredReceiving bank didn't return a response on timeTransaction failed as the recipient bank failed to verify the transaction. Please retry your transaction again in a few hours.
DS25OrderFileDeleted
DS26UserSignedMultipleTimes
DS27UserNotYetActivated
DT01InvalidDate
DT02InvalidCreationDate
DT03InvalidNonProcessingDate
DT04FutureDateNotSupported
DT05InvalidCutOffDateInvalid timeTransaction failed as the system flagged an invalid date format in the transaction. Please retry, and contact [email protected] if the problem persists.
DT06ExecutionDateChanged
DU01DuplicateMessageID
DU02DuplicatePaymentInformationID
DU03DuplicateTransactionDuplicate transaction was madeTransaction failed as the transaction appears to be a duplicate. Please review your transactions, and try again.
DU04DuplicateEndToEndID
DU05DuplicateInstructionID
DUPLDuplicatePayment
ED01CorrespondentBankNotPossible
ED03BalanceInfoRequest
ED05SettlementFailed
ED06SettlementSystemNotAvailable
ERINERIOptionNotSupported
FF01Invalid File Format
FF02SyntaxErrorCould be anything. Error in system code.Transaction failed due to a technical error. Please retry, and contact [email protected] if the problem persists.
FF03InvalidPaymentTypeInformation
FF04InvalidServiceLevelCode
FF05InvalidLocalInstrumentCodeOther party is not allowed to use the transfer feature. Example a bank who have not activated QR transfer but we are sending QR transfer to them.Transaction failed as this bank does not support the selected transfer method. Please try another transfer option.
FF06InvalidCategoryPurposeCode
FF07InvalidPurpose
FF08InvalidEndToEndId
FF09InvalidChequeNumber
FF10BankSystemProcessingErrorError on the other sideTransaction failed as the recipient bank encountered an issue. Try again later, or contact [email protected] for assistance.
FF11ClearingRequestAborted
G000Payment transferred and not tracked
G001CreditDebitNotConfirmed
G002CreditDebitNotConfirmed
G003CreditPendingDocuments
G004CreditPendingFunds
G005DeliveredWithServiceLevel
G006DeliveredWIthoutServiceLevel
ID01CorrespondingOriginalFileStillNotSent
MD01NoMandate
MD02MissingMandatoryInformationIn Mandate
MD05CollectionNotDue
MD06RefundRequestByEndCustomer
MD07EndCustomerDeceased
MS02NotSpecifiedReasonCustomer Generated
MS03NotSpecifiedReasonAgent Generated
NARRNarrative NERI NoERILegacy system errorTransaction failed due to a system error. Please retry later. If the problem persists, contact [email protected] for assistance.
RC01BankIdentifierIncorrect
RC02InvalidBankIdentifier
RC03InvalidDebtorBankIdentifier
RC04InvalidCreditorBankIdentifierMerchant sent to an account number that doesn't existTransaction failed as the recipient's account number is invalid or does not exist. Please double-check the details and enter the correct account number before trying again.
RC05InvalidBICIdentifier
RC06InvalidDebtorBICIdentifier
RC07InvalidCreditorBICIdentifier
RC08InvalidClearingSystemMemberIdentifier
RC09InvalidDebtorClearingSystemMemberIdentifier
RC10InvalidCreditorClearingSystemMemberIdentifier
RC11InvalidIntermediaryAgent
RC12MissingCreditorSchemeId
RCONR-MessageConflict
RF01NotUniqueTransactionReference
RR01Missing Debtor Account or Identification
RR02Missing Debtor Name or Address
RR03Missing Creditor Name or Address
RR04RegulatoryReason
RR05RegulatoryInformationInvalid
RR06TaxInformationInvalid
RR07RemittanceInformationInvalid
RR08RemittanceInformationTruncated
RR09InvalidStructuredCreditorReference
RR10InvalidCharacterSet
RR11InvalidDebtorAgentServiceID
RR12InvalidPartyID
S000ValidRequestForCancellationAcknowledged
S001UETRFlaggedForCancellation
S002NetworkStopOfUETR
S003RequestForCanacellationForwarded
S004RequestForCancellationDeliveryAcknowledgement
SL01Specific Service offered by Debtor Agent
SL02Specific Service offered by Creditor Agent
SL11Creditor not on Whitelist of Debtor
SL12Creditor on Blacklist of Debtor
SL13Maximum number of Direct Debit Transactions exceeded
SL14Maximum Direct Debit Transaction Amount exceeded
TA01TransmissonAborted
TD01NoDataAvailable
TD02FileNonReadable
TD03IncorrectFileStructure
TM01InvalidCutOffTimeTransaction did not complete within alloted cut off time.Transaction failed as it didn't meet the alloted cut off time for processing. Please retry again within banking hours.
TS01TransmissionSuccessful
TS04TransferToSignByHand

Error Codes Unique to InstaPay

The table of codes stated below are error codes that are only applicable to InstaPay.

Error CodeCode ExplanationExplanationAction
9909IPS Switch system malfunction
9910Receiving Bank - Logged OffReceiving bank is offlineTransaction failed as the receiving bank is currently offline. Please try again after a few hours.
9912Rvc Participant not availableReceiving participant is offlineTransaction failed as the recipient bank is currently unavailable. Please try again later.
9920Interbank Fee Code invalid
9921Application Criteria is invalid
9922Type of Person is invalid
9923Rate Debit Concept is not numeric
9924Invalid Asset Indicator
9925Invalid Month of Payment
9926Month/Year of Payment is not numeric
9934Sending Participant offline
9946Sending Participant fully suspended
9947Receiving Participant fully suspended
9948Service suspended
9964Invalid Bank Identification
NOATMessage Type not supported

Other Common Transfer Errors

Error MessageExplanationAction
transaction_limit_exceededTransaction went past 50k for Instapay or 10M for PesonetTransaction failed as it exceeded the allowed limit. InstaPay allows up to P50,000 per transaction, while PESONet allows up to P10 million. Please adjust the amount and try again.
internal_server_errorRaise to treasury team. Send give as much info as you can, transfer id, payload etc.Transaction failed due to an unexpected server error. Please try again after a few hours. If issue persists, please contact [email protected] for assistance.
parameter_above_maximumPayload values above the maximumTransaction failed as it exceeded the allowed limit. InstaPay allows up to P50,000 per transaction, while PESONet allows up to P10 million. Please adjust the amount and try again.
parameter_format_invalidInvalid payloadTransaction failed due to incorrect details. Please check all transaction information, such as the recipient’s account number and amount, and try again.
provider_processing_error3rd party (instapay / pesonet) errorTransaction failed due to a processing error with the provider. Please retry later. If the problem persists, contact [email protected] for assistance.
too_many_requestsRate limitedTransaction failed as too many requests have been made. Please wait a few minutes before trying again.
resource_frozen_stateaccount is frozenTransaction failed as the recipient account is frozen and cannot receive payments. Please contact [email protected] for assistance.
resource_not_foundaccount not foundTransaction failed as the account does not exist. Please verify the account details and try again. If the problem persists, contact [email protected] for assistance.
transfer_to_self_not_allowedMerchant is sending to their own walletTransaction failed as sending to your own account is not allowed. Please enter a different recipient account.
resource_closed_stateaccount is closedTransaction failed as the recipient’s account is closed. Please transfer to a different recipient account.