PayTo Status and Error Codes

this page lists all possible status and error codes for payto agreements and initiations it's recommended to handle 400 and 500 response codes generally and search this page when an unknown error is encountered, rather than handling every possible error individually client error responses response structure field description comment validation traceid string traceid for the trace logs currently only populated for errors optional errors\[i] errormessage string detailed error messages for this error instance optional errors\[i] errorcode string monoova error code mandate errors error\[] array of individual errors, if any “errors” will be null or absent of no errors occur optional sample response { "traceid" "4ea61012 2d9b 413d a5b4 90ad69a68741", "errors" \[ { "errorcode" "nos vl evtname required", "errormessage" "'eventname' must not be empty " } ] } mandate status reason codes code description m001 invalid debtor accountnumber m002 closed account number m003 closed debtor accountnumber m004 blocked account m005 invalid debtor accounttype m006 transaction forbidden m007 transaction not supported m008 not allowed currency m009 invalid amount m010 amount exceeds agreed limit m011 contract amended m012 contract cancellation initiated by debtor m013 contract expired m014 mandate suspended final collection m015 mandate suspended once off collection m016 end customer deceased m017 no mandate service by agent m018 no mandate service on customer m019 requested by customer m020 requested by initiating party m021 mandate expired m022 mandate cancelled due to fraud m023 not specified reason customer generated m024 not specified reason agent generated m025 mandate suspended 7 consecutive unsuccessful collections m026 narrative m027 no answer from customer m028 regulatory reason m029 specific service offered by debtor agent m030 creditor not on whitelist of debtor m031 creditor on blacklist of debtor m032 unknown end customer payment initiation status http status code status description intermediate status 202 accp accepted customer profile 202 acsp accepted settlement in process 202 inpr in progress 202 recv received 202 safd participant down 202 sent sent to payer 202 undv undelivered final status 201 acsc accepted settlement completed 422 rjct rejected payment initiation reject reason codes code description r001 creditor agent is not online r002 account to be debited does not exist r003 account to be credited does not exist r004 the original payer customer account number is closed r005 account exists but is blocked r006 account is now closed r007 debtor account type is invalid r008 creditor account type is invalid r009 payer account is not valid r010 transaction has been forbidden r011 payment was rejected by the payee r012 debtor account cannot be debited r013 use of zero dollar payment initiation requests is prohibited r014 the amount requested is greater than the maximum npp limit of $99,999,999,999 r015 specified message amount is a non processable currency outside of existing agreement r016 amount of funds available to cover specified message amount is insufficient r017 specified transaction amount is less than agreed minimum r018 amount received is not the amount agreed or expected r019 the amount in the npp payment initiation request is missing or invalid r020 number of transactions at the group level is invalid or missing r021 the amount requested in the npp payment initiation request exceeds the agreed limit r022 reject the npp payment initiation request as the creditor is unknown to debtor r023 end customer specified is not known at associated sort/national bank code or does no longer exist in the books r024 debtor name not provided r025 creditor name not provided r026 number of decimal points not compatible with the currency r027 required compulsory element missing r028 the currency included in the clearing request is incorrect (value other than aud) r029 cancellation requested by the debtor r030 the creationdatetime in the group header is not as per the required format r031 the business service does not support future dated npp payment initiation requests r032 check with monoova on possible outage retry again after sometime r033 check with monoova on possible outage retry again after sometime r034 end to end id missing or invalid for payment instruction r035 invalid or not applicable character set r036 creditor reference must be equal to end to end id of payment instruction r037 check with monoova on possible outage retry again after sometime r038 payer institution is unavailable r039 payer institution is unavailable r040 payer institution is unavailable r041 payer payid is not valid update the payment agreement with a valid payid to proceed with payment initiation r042 payer payid is not valid update the payment agreement with a valid payid to proceed with payment initiation r043 payer bsb is not valid update the payment agreement with a valid bsb to proceed with payment initiation r044 payer bsb is not valid update the payment agreement with a valid bsb to proceed with payment initiation r045 bo service code is not valid modify the mandate with the correct bo service code r046 bo service code is not valid modify the mandate with the correct bo service code r047 payer is no longer reachable on npp cancel the mandate r048 payer is no longer reachable on npp cancel the mandate r049 payee account details are not present in mandate and client also has not provided creditor account details in the initiation request either modify the mandate or provide the creditor account details in the request r050 creditor payid has been ported, amend the payment agreement to reflect correct payid institution r051 payer payid has been ported, amend the payment agreement to reflect correct payid institution r052 payee account details in the payment initiation do not match the payment agreement r053 payee payid in the payment initiation do not match the payment agreement r054 verify the details of the mandate, if creditor details are not present, it must be provided in input request r055 unable to locate payment instruction record r056 mandate validation failed verify the details of the mandate r057 verify the details of the mandate, if creditor account/alias details are correct, don't send creditor account/alias details in input request r058 verify the status of previous payment instruction if it is valid for business retry r059 the npp payment initiation request did not contain a mandateid r060 invalid payment agreement r061 payment agreement is expired r062 reason has not been specified by end customer r063 permission to process this payment is not granted r064 check with monoova on possible outage retry again after sometime r065 the bic identifier in the message payload is invalid or missing r066 due to specific service offered by the debtor agent r067 the creditor did not appear on the debtors whitelist r068 the creditor did appear on the debtors blacklist r069 the npp payment initiation request was rejected because the number of transactions requested exceeds the debtor agent offering r070 the npp payment initiation request was rejected because the total value of transactions requested exceeds the debtor agent offering r999 unexpected system error monoova error codes http status error code meaning 400 nos acctid required maccount is required 400 nos daterange invalid end must be after start 400 nos daterange size days between start and end must be smaller than {0} 400 nos dup sub crt error duplicate record already exists or subscriptionid not provided 400 nos enddate invalid invalid end 400 nos evtid required eventid must not be empty 400 nos evtname invalid {0}eventname must not be empty and be one of \[{1}] 400 nos evtname required {0}eventname is required 400 nos header required header must not be empty 400 nos isactive required {0}isactive must not be empty 400 nos pgnum invalid pagenumber must be greater than 0 400 nos pgsiz invalid pagesize must be from 1 to {0} 400 nos request empty request payload is empty 400 nos startdate invalid invalid start 400 nos sts invalid status must be one of \[{0}] 400 nos subid invalid subscriptionid must be a valid guid 400 nos subid required subscriptionid is required 400 nos subname invalid {0}subscriptionname must not be empty and match {regularexpression} 400 nos subname required {0}subscriptionname must not be empty 400 nos traceid required traceid is required 400 nos url invalid {0}callbackurl must not be empty and must be a well formed url 400 nos url required {0}callbackurl is required 400 nos validation error one or more validation failures have occurred 400 nos webdtl required {0}webhookdetail is required 400 pas req body invalid error parsing badly formed request message {0} 404 nos event not found error no webhook found for {0} 404 nos sub not found error subscriptionid {0} is not found 500 nos del sub error document deleted {0} expected exactly 1 subscription deletion 500 nos dup sub upd error duplicate records exist for subscriptionid {0} 500 nos unexpected error an unexpected exception occurred 500 nos upd sub error document modified {0} expected exactly 1 subscription updated 400 pam acctid required maccount is required 400 pam action invalid actionstatus {propertyvalue} is invalid must be one of \[{0}] 400 pam amend forbidden can only amend payment agreement in active or paused status 400 pam amend pending can not amend payment agreement with pending bilateral amend 400 pam amount error {0} invalid payment amount {1} 400 pam amt gtr max amt amount can not be greater than maximum amount 400 pam amt invalid {0} amount is invalid {propertyvalue} 400 pam amt type invalid combination for payment amount type {0} 400 pam amt type unsupported unsupported payment amount type {0} 400 pam auto renewal required {0} automaticrenewal is required 400 pam bsb account together bsb and account must be provided together 400 pam business rule error startdate invalid 400 pam cancel created payment agreement is in created status please use our recall api to cancel the pag creation 400 pam crtd enddate invalid createdenddate must be past time and within 1 month after createdstartdate 400 pam crtd startdate invalid createdstartdate must be past time 400 pam debtor paused payment agreement paused by debtor can only be resumed by debtor 400 pam desc invalid {0} description must have minimum 1 400 pam desc short desc missing either description or shortdescription or both must be provided 400 pam details required paymentdetails required 400 pam dup payee the payee information has been provided in both the payment agreement 400 pam enddate before start enddate cannot be earlier than paymentagreement startdate 400 pam enddate early {0} enddate {propertyvalue} must be later than {0} startdate 400 pam enddate forbidden {0} enddate is prohibited when automaticrenewal is true 400 pam enddate invalid {0} enddate {propertyvalue} must match yyyy mm dd 400 pam enddate required {0} enddate is required when automaticrenewal is false 400 pam enddate too old enddate must be a future date 400 pam enddate with autorenew enddate cannot be provided unless automaticrenewal is false 400 pam invalid operation paymentagreementstatus {0} is invalid for the change to {1} 400 pam invalid purpose purpose code {0} not allowed 400 pam invalid time format {0} executiontime must match hh\ mm\ ss 400 pam mapping error internal error property {0} value {1} is invalid expected one of \[{2}] please contact monoova support 400 pam max amt invalid {0} maximumamount is invalid {propertyvalue} 400 pam num trans invalid {0} numberoftransactionspermitted must not be less than or equal to 0 400 pam pagid invalid paymentagreementuid {propertyvalue} must match {regularexpression} 400 pam pagid required paymentagreementuid required 400 pam pagmmsid required either paymentagreementuid or mmsid must not be empty 400 pam pag exists failed to create payment agreement paymentagreementuid already linked to mmsid 400 pam pag limit exceeded request exceeds the maximum allowed payment agreement limit {0} 400 pam pag purpose invalid {0} purpose value {propertyvalue} invalid must be one of \[{1}] 400 pam pag status inactive agreement status must be active 400 pam pag type invalid {0} agreementtype value {propertyvalue} invalid must be one of \[{1}] 400 pam payee account name forbidden payee account name is not allowed 400 pam payee acct empty {0} payeelinkedaccount {propertyvalue} cannot be all zeros or blanks 400 pam payee acct forbidden {0} payeelinkedaccount prohibited with payeelinkedpayid 400 pam payee acct invalid {0} payeelinkedaccount {propertyvalue} must match {regularexpression} 400 pam payee acct length {0} payeelinkedaccount must not be longer than 28 characters 400 pam payee acct missing the payee account information has not been provided 400 pam payee acct name forbidden {0} payeeaccountname must be empty when payeelinkedbsb is monoova 400 pam payee acct name invalid {0} payeeaccountname {propertyvalue} must match {regularexpression} 400 pam payee acct name required {0} payeeaccountname must not be empty 400 pam payee acct required {0} payeelinkedaccount required if no payeelinkedpayid 400 pam payee bsb forbidden {0} payeelinkedbsb prohibited with payeelinkedpayid 400 pam payee bsb invalid {0} payeelinkedbsb {propertyvalue} must match {regularexpression} 400 pam payee bsb required {0} payeelinkedbsb required if no payeelinkedpayid 400 pam payee bsb restricted the specified payee bsb {0} is not allowed 400 pam payee empty {0} must contain at least one input field 400 pam payee forbidden the account information provided does not match the list of allowed payees 400 pam payee id invalid {0} payeelinkedpayid value invalid for specified payeelinkedpayidtype 400 pam payee id type forbidden {0} payeelinkedpayidtype prohibited without payeelinkedpayid 400 pam payee id type invalid {0} payeelinkedpayidtype {propertyvalue} invalid must be one of \[{1}] 400 pam payee id type required {0} payeelinkedpayidtype required for payeelinkedpayid 400 pam payee missing the payee information has not been provided in either the payment agreement 400 pam payee type invalid {0} payeetype {propertyvalue} is invalid must be one of \[{1}] 400 pam payer acct empty {0} linkedaccount {propertyvalue} cannot be all zeros or blanks 400 pam payer acct forbidden {0} linkedaccount prohibited with linkedpayid 400 pam payer acct invalid {0} linkedaccount {propertyvalue} must match {regularexpression} 400 pam payer acct length {0} linkedaccount must be between 1 and 28 characters 400 pam payer acct required {0} linkedaccount required if no linkedpayid 400 pam payer bsb forbidden {0} linkedbsb prohibited with linkedpayid 400 pam payer bsb invalid {0} linkedbsb {propertyvalue} must match {regularexpression} 400 pam payer bsb required {0} linkedbsb required if no linkedpayid 400 pam payer forbidden the account information provided does not match the list of allowed payers 400 pam payer id invalid {0} linkedpayid invalid format for linkedpayidtype 400 pam payer id type forbidden {0} linkedpayidtype prohibited without linkedpayid 400 pam payer id type invalid {0} linkedpayidtype {propertyvalue} invalid must be one of \[{1}] 400 pam payer id type required {0} linkedpayidtype required for linkedpayid 400 pam payer missing the payer information has not been provided in either the payment agreement 400 pam payer name invalid {0} payer {propertyvalue} must match {regularexpression} 400 pam payer name length {0} payer must be between 1 and 140 characters 400 pam payer name required {0} payer required 400 pam payer party alnum {0} payerpartyreference must contain at least one alphanumeric character 400 pam payer party invalid {0} payerpartyreference value {propertyvalue} does not match {regularexpression} 400 pam payer party length {0} payerpartyreference must be from 1 to 35 characters 400 pam payer party required {0} payerpartyreference required 400 pam payer payee exists failed to create approvedpayerpayee account already exists 400 pam payer required payerdetails required 400 pam payer type invalid {0} payertype {propertyvalue} invalid must be one of \[{1}] 400 pam payer type required {0} payertype required 400 pam paymentinformation frequencycombinationrule either pointintime or numberoftransactionspermitted must be present in paymentterms 400 pam pg num invalid pagenumber must be greater than zero 400 pam pg sz invalid pagesize must be between 1 and {0} 400 pam pit forbidden paymentinformation pointintime must not be present when paymentfrequency is {0} 400 pam pit invalid {0} pointintime must be 2 digits string 400 pam pmt freq invalid {0} paymentfrequency {propertyvalue} invalid must be one of \[{1}] 400 pam pmt freq required {0} paymentfrequency is required 400 pam reason code invalid reasoncode {propertyvalue} is invalid must match one of \[{0}] 400 pam reason code required reasoncode is required when statuschange is pause or cancel 400 pam reason desc invalid reasondescription is invalid must be from 1 to 256 characters 400 pam recall invalid action {0} in payment agreement {1} invalid status must be pending for recall 400 pam record not found error requested record could not be found 400 pam request empty request payload is empty 400 pam req body invalid error parsing badly formed request message {0} 400 pam resolution invalid {0} respondbytime must be between now and 5 days in the future 400 pam sched invalid schedulepaymentinitiation not yet supported if provided value must be false 400 pam short desc invalid {0} shortdescription must have minimum 1 400 pam startdate early {0} startdate must be future date 400 pam startdate invalid {0} startdate {propertyvalue} must match yyyy mm dd 400 pam startdate required {0} startdate is required 400 pam status chg invalid statuschange {propertyvalue} is invalid must be one of \[{0}] 400 pam status chg required statuschange is required 400 pam terms required paymentterms required 400 pam tz invalid {0} respondbytime requires a time and timezone 400 pam ultimate payee forbidden payee ultimate name not allowed 400 pam ult payee forbidden {0} ultimatepayee must be empty when payeelinkedbsb is monoova 400 pam ult payee invalid {0} ultimatepayee {propertyvalue} must match {regularexpression} 400 pam ult payee required {0} ultimatepayee must not be empty 400 pam ult payer invalid {0} ultimatepayer {propertyvalue} must match {regularexpression} 400 pam ult payer length {0} ultimatepayer must be between 1 and 140 characters 400 pam ult payer required {0} ultimatepayer required 400 pam validation error error validating request message {0} 403 pam forbidden error not allowed to {0} for account {1} 404 pam acct not found error account not found for accountid {0} 404 pam action not found error action {0} not found in payment agreement {1} 404 pam pag fqn not found error unable to find payment agreement with account {0} paymentagreementuid {1} mmsid {2} 404 pam pag not found error paymentagreement not found for paymentagreementuid {0} 404 pam party not found error approvedpayerpayee with approvalid {0} and maccount {1} not found 500 pam acct cfg purpose error purpose code not provided in agreement and default value not configured in account 500 pam acct not found error account not found for accountid {0} 500 pam acct update error documents modified {0} expected exactly 1 accountconfiguration updated 500 pam mapping error internal error property {0} value {1} is invalid expected one of \[{2}] please contact monoova support 500 pam pag create error failed to create payment agreement in repository 500 pam pag not found error paymentagreement not found for paymentagreementuid {0} 500 pam pag update error documents modified {0} expected exactly 1 payment agreement updated 500 pam pag upsert error documents modified {0} expected 0 or 1 payment agreement updated 500 pam party create error failed to create approvedpayerpayee in repository 500 pam party update error documents modified {0} expected exactly 1 approvedpayerpayee updated 500 pam uid not unique more than one paymentagreementuid {0} is found 500 pam unexpected error internal server error please contact monoova support 502 pam npp gateway error error returned from npp gateway {0} 504 pam npp gateway timeout timeout from npp gateway 202 pas in progress status requested operation is still pending 400 pas acctid required maccount is required 400 pas acc prd limit exceeded payment amount requested {0} plus amount used {1} exceeds remaining account limit {2} for period 400 pas agreement ended the end date has been exceeded on the payment agreement 400 pas agreement invalid invalid payment agreement amount or currency information please contact monoova support 400 pas agreement not started the start date on the payment agreement is greater than the current date 400 pas amount error payment initiation amount {0} currency {1} are null or invalid 400 pas amount mismatch the amount {0} {1} does not match the active amount of the payment agreement {2} {3} 400 pas amt exceeded the amount {0} exceeds the active allowed amount of the payment agreement {1} 400 pas amt invalid {0} amount is invalid {propertyvalue} 400 pas amt required {0} amount is required 400 pas business rule error business rule failure {0} 400 pas count limit exceeded count of payments {0} exceeds configured limits {1} for the specified payment agreement 400 pas count limit undefined payment count limit zero or not defined for the specified payment agreement 400 pas duplicate instruction failed to create payment instruction duplicate paymentinitiationuid 400 pas enddate exceeded createdenddate invalid may not be more than {0} months after createdstartdate 400 pas enddate invalid createdenddate invalid must be after createdstartdate 400 pas fail limit exceeded number of failed payment requests {0} exceeds limit of {1} per day 400 pas limit unavailable invalid account configuration for allowed payment initiations for the day please contact monoova support 400 pas mapping error internal error property {0} value {1} is invalid expected one of \[{2}] please contact monoova support 400 pas max amt exceeded the amount {0} exceeds the allowed maximumamount of the payment agreement {1} 400 pas pagid invalid paymentagreementuid value {propertyvalue} must match {regularexpression} 400 pas pagid required paymentagreementuid required 400 pas payee acctname forbidden {0} payeeaccountname must be empty when payeelinkedbsb is monoova 400 pas payee acctname invalid {0} payeeaccountname {propertyvalue} must match {regularexpression} 400 pas payee acctname length {0} payeeaccountname must be from 1 to 140 characters 400 pas payee acctname required {0} payeeaccountname required 400 pas payee acct forbidden {0} payeelinkedaccount prohibited with payeelinkedpayid 400 pas payee acct invalid {0} payeelinkedaccount {propertyvalue} must match {regularexpression} 400 pas payee acct length {0} payeelinkedaccount must be from 1 to 28 characters 400 pas payee acct required {0} payeelinkedaccount required if no payeelinkedpayid 400 pas payee acct zero {0} payeelinkedaccount {propertyvalue} must not be all zero or blank 400 pas payee bsb forbidden {0} payeelinkedbsb prohibited with payeelinkedpayid 400 pas payee bsb invalid {0} payeelinkedbsb {propertyvalue} must match {regularexpression} 400 pas payee bsb required {0} payeelinkedbsb required if no payeelinkedpayid 400 pas payee empty {0} (payeedetails) must contain at least one input field 400 pas payee id invalid {0} payeelinkedpayid invalid format for payeelinkedpayidtype 400 pas payee payid type forbidden {0} payeelinkedpayidtype prohibited without payeelinkedpayid 400 pas payee payid type invalid {0} payeelinkedpayidtype value {propertyvalue} invalid must be one of \[{1}] 400 pas payee payid type required {0} payeelinkedpayidtype required for payeelinkedpayid 400 pas payee type invalid {0} payeetype value {propertyvalue} invalid must be one of \[{1}] 400 pas payment too soon the payment execute not before time has been exceeded on the payment agreement 400 pas period count exceeded initiation count {0} exceeds maximum allowed payment initiations for the day {1} 400 pas pmtdtl required paymentdetails required 400 pas pmtid required paymentid is required 400 pas pmt uid invalid paymentinitiationuid {propertyvalue} must match {regularexpression} 400 pas pmt uid required paymentinitiationuid required 400 pas ref invalid {0} lodgementreference invalid >400 pas request empty request payload is empty 400 pas req body invalid error parsing badly formed request message {0} 400 pas startdate invalid createdstartdate invalid must be past date 400 pas startdate required createdstartdate required 400 pas supercode invalid {0} uniquesuperannuationcode {propertyvalue} must match {regularexpression} 400 pas supercode required {0} uniquesuperannuationcode is mandatory if uniquesuperannuationidentification is given 400 pas superid invalid {0} uniquesuperannuationidentification {propertyvalue} must match {regularexpression} 400 pas superid required {0} uniquesuperannuationidentification is mandatory if uniquesuperannuationcode is given 400 pas trnsts invalid transactionstatus value {propertyvalue} invalid must be one of \[{0}] 400 pas trnsts required transactionstatus required 400 pas ult payee forbidden {0} ultimatepayee must be empty when payeelinkedbsb is monoova 400 pas ult payee invalid {0} ultimatepayee {propertyvalue} must match {regularexpression} 400 pas ult payee length {0} ultimatepayee must be from 1 to 140 characters 400 pas ult payee required {0} ultimatepayee required 400 pas validation error error validating request message {0} 404 pas agreement not found the paymentagreement with the provided id was not found {0} 404 pas instruction not found paymentinstruction {0} is not found 500 pas application error an application error occurred while processing the request please try again later if the problem persists please contact monoova support 500 pas data update error documents modified {0} expected exactly 1 payment instruction updated 500 pas iid not unique more than one paymentinstructionuid {0} is found 500 pas limit reset error daily limit reset request returned error {0} 500 pas mapping error internal error property {0} value {1} is invalid expected one of \[{2}] please contact monoova support 500 pas pam timeout error timeout calling mandatemanager service please try again later 500 pas unexpected error internal server error please contact monoova support 502 pas npp gateway error error returned from npp gateway {0} 502 pas npp gateway noresponse received empty response from npp gateway {0} 504 pas npp gateway timeout timeout calling npp gateway 400 mov unexpected validation failure validation failed with banking partner contact monoova for more information 400 mov validation error unexpected validation error correct payload and retry 400 mov payer alias validation failed unexpected validation error with payer alias correct payload and retry 400 mov multiple field change error unexpected validation error multiple changed fields exist with respondbytime correct request and retry 400 mov missing field error unexpected validation error include amended fields 400 mov respond by time validation failed unexpected validation error with respondbytime correct payload and retry 400 mov description validation failed unexpected validation error with descriptions correct payload and retry 404 mov linked payid error incorrect linkedpayid details 404 mov payee linked payid error incorrect payeelinkedpayid details 400 mov npp payment not supported payee account cannot receive npp payments 404 mov payee detail error incorrect payee details 409 mov banking partner error unexpected error with banking partner contact monoova for more details 403 mov configuration error configuration error contact monoova 400 mov amend status validation failed unexpected validation error with amend status correct payload and retry 403 mov permission denied configuration error you do not have permission to perform this action contact monoova 400 mov invalid bsb invalid bsb number 400 mov validation failed unexpected validation error contact monoova