{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-products/billpay/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Error Handling","siteUrl":"https://docs.monato.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"error-handling","__idx":0},"children":["Error Handling"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Requests to our APIs can result in several different types of error responses. A list of error messages, along with their correspinding example, is provided in the following description."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-responses","__idx":1},"children":["Error Responses"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["An API request that fails tipically results in the following error response:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n  \"error_type\": \"PAYEE_ID_INVALID\",\n  \"error_message\": \"Payee ID Invalid\"\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error_type"]},": The type of error."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error_message"]},": Error description in human-readable form."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"ERROR TYPE"},"children":["ERROR TYPE"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"ERROR MESSAGE"},"children":["ERROR MESSAGE"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"KIND OF ERROR"},"children":["KIND OF ERROR"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["INVALID_REQUEST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["We can't process your request"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Operative"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["INTERNAL_ERROR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["There was an error while processing your request"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Operative"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PAYEE_ID_INVALID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payee ID Invalid"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Operative"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PAYEE_SERVICE_UNAVAILABLE"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payee service is not available at this time, retry in 5 minutes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Operative"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PAYER_ACCOUNT_INVALID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid payer account"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Operative"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PAYER_ACCOUNT_NOT_FOUND"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payer account not found for the Payee"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Operative"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CANNOT_FULFILL_REQUEST"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["We cannot currently fulfill requests for this Payee"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Integration"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AMOUNT_INSUFFICIENT"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Payee minimum amount was not met"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Operative"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AMOUNT_FORMAT_INVALID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The amount format is incorrect"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Operative"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["TOPUP_AMOUNT_NOT_AVAILABLE"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Topup amount is not available"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Integration"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CURRENCY_INVALID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The Payee does not accept this currency"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Operative"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PAYEE_TIMEOUT"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payee service is not responding at this time"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Integration"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PAYEE_CONNECTION_ERROR"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Error with the Payee connection"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Integration"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["UPLOAD_FILE_S3_FAILED"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The file upload to s3 bucket failed"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Operative"]}]}]}]}]}]},"headings":[{"value":"Error Handling","id":"error-handling","depth":1},{"value":"Error Responses","id":"error-responses","depth":2}],"frontmatter":{"seo":{"title":"Error Handling"}},"lastModified":"2026-06-23T21:56:40.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/billpay/guides/error-handling","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}