{"id":2847,"date":"2022-11-09T22:24:47","date_gmt":"2022-11-09T22:24:47","guid":{"rendered":"https:\/\/serviceobjects.wpaladdin.com\/?page_id=2847"},"modified":"2025-08-22T08:42:11","modified_gmt":"2025-08-22T15:42:11","slug":"bv-errors","status":"publish","type":"page","link":"https:\/\/www.serviceobjects.com\/docs\/dots-bin-validation\/bv-errors\/","title":{"rendered":"BV &#8211; Errors"},"content":{"rendered":"<nav aria-label=\"Error Types Navigation\">\n<ul class=\"is-style-bullets-list\">\n<li><a href=\"#ErrorTypes\">Error Types<\/a>\n<ul>\n<li><a href=\"#Errortype1Authorization\">Error type 1: Authorization<\/a><\/li>\n<li><a href=\"#Errortype2UserInput\">Error type 2: User Input<\/a><\/li>\n<li><a href=\"#Errortype3ServiceObjectsFatal\">Error type 3: Service Objects Fatal<\/a><\/li>\n<li><a href=\"#Errortype4DomainSpecific\">Error type 4: Domain Specific<\/a><\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<\/nav>\n<p>&nbsp;<\/p>\n<article aria-label=\"General error explanation\">Generally, an error is anything that happens during a run of DOTS BIN Validation that causes the service to fail. If an error occurs, an XML error message, similar to the one below, will result instead of the BinValidationInfo output described above:<\/article>\n<p>&nbsp;<\/p>\n<article aria-label=\"Error example\"><strong>Example:<\/strong><\/article>\n<figure class=\"wp-block-table is-style-regular\">\n<table>\n<tbody>\n<tr>\n<td class=\"has-text-align-left\" data-align=\"left\">\u00a0<\/td>\n<td><strong>*Error!*<\/strong><br \/>\u00a0 &lt;Type&gt;Authorization&lt;\/Type&gt;<br \/>\u00a0 &lt;TypeCode&gt;1&lt;\/TypeCode&gt;<br \/>\u00a0 &lt;Desc&gt;Your license key does not work on this service.&lt;\/Desc&gt;<br \/>\u00a0 &lt;DescCode&gt;8&lt;\/DescCode&gt;<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<article aria-label=\"Error types introduction\">There are four error types described below.<\/article>\n<section aria-labelledby=\"ErrorTypes\">\n<h2 id=\"ErrorTypes\">Error Types<\/h2>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th scope=\"col\">Type<\/th>\n<th scope=\"col\">Type Code<\/th>\n<th scope=\"col\">Billable<\/th>\n<th scope=\"col\">Standard Across All Gen2 Web Services<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Authorization<\/td>\n<td>1<\/td>\n<td>No<\/td>\n<td>Yes<\/td>\n<\/tr>\n<tr>\n<td>User Input<\/td>\n<td>2<\/td>\n<td>Yes<\/td>\n<td>No<\/td>\n<\/tr>\n<tr>\n<td>Service Objects Fatal<\/td>\n<td>3<\/td>\n<td>No<\/td>\n<td>Yes<\/td>\n<\/tr>\n<tr>\n<td>Domain Specific<\/td>\n<td>4<\/td>\n<td>Yes<\/td>\n<td>No<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<section aria-labelledby=\"Errortype1Authorization\">\n<h2 id=\"Errortype1Authorization\">Error type 1: Authorization<\/h2>\n<article aria-label=\"Authorization error explanation\">These are standard to all Generation 2 DOTS Web Services.<\/article>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th scope=\"col\">DescCode<\/th>\n<th scope=\"col\">Desc<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>0<\/td>\n<td>Unknown authorization error.<\/td>\n<\/tr>\n<tr>\n<td>1<\/td>\n<td>Please provide a valid license key for this web service.<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>The daily allowable number of transactions for this license key has been exceeded.<\/td>\n<\/tr>\n<tr>\n<td>3<\/td>\n<td>The monthly allowable number of transactions for this license key has been exceeded.<\/td>\n<\/tr>\n<tr>\n<td>4<\/td>\n<td>The total allowable number of transactions for this license key has been exceeded.<\/td>\n<\/tr>\n<tr>\n<td>5<\/td>\n<td>There are not enough transactions available. Check your daily\/monthly transaction limits.<\/td>\n<\/tr>\n<tr>\n<td>6<\/td>\n<td>This license key has not yet been activated.<\/td>\n<\/tr>\n<tr>\n<td>7<\/td>\n<td>This license key has expired.<\/td>\n<\/tr>\n<tr>\n<td>8<\/td>\n<td>Your license key does not work on this service.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<section aria-labelledby=\"Errortype2UserInput\">\n<h2 id=\"Errortype2UserInput\">Error type 2: User Input<\/h2>\n<article aria-label=\"User input error explanation\">User Input errors are caused when a user inputs an invalid value or fails to provide a certain input field altogether. If a developer creates a request and mistypes a parameter name, it will probably cause a User Input Error.<\/article>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th scope=\"col\">DescCode<\/th>\n<th scope=\"col\">Desc<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>&#8220;You must input a license key in the LicenseKey field.&#8221;<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>&#8220;Improper BIN format. Please input a valid BIN.&#8221;<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<section aria-labelledby=\"Errortype3ServiceObjectsFatal\">\n<h2 id=\"Errortype3ServiceObjectsFatal\">Error type 3: Service Objects Fatal<\/h2>\n<article aria-label=\"Service Objects Fatal error explanation\">The Desc will always be the same and the DescCode has no meaning. This is standard to all Generation 2 DOTS Web Services. This is a rare error that signals either a bug in the DOTS BIN Validation service, or a Network\/Connectivity issue.<\/article>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th scope=\"col\">DescCode<\/th>\n<th scope=\"col\">Desc<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>&#8220;Unhandled error. Please contact Service Objects.&#8221;<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n<section aria-labelledby=\"Errortype4DomainSpecific\">\n<h2 id=\"Errortype4DomainSpecific\">Error type 4: Domain Specific<\/h2>\n<article aria-label=\"Domain specific error explanation\">Domain specific errors represent the common errors seen in Service Objects services. Domain Specific errors indicate that the service completed successfully but the result is not good.<\/article>\n<figure class=\"wp-block-table is-style-table-section\">\n<table>\n<thead>\n<tr>\n<th scope=\"col\">DescCode<\/th>\n<th scope=\"col\">Desc<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>1<\/td>\n<td>&#8220;BIN not found. Please input a valid BIN.&#8221;<\/td>\n<\/tr>\n<tr>\n<td>2<\/td>\n<td>&#8220;Bank information is currently unavailable.&#8221;<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/figure>\n<\/section>\n","protected":false},"excerpt":{"rendered":"<p>Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Error type 4: Domain Specific &nbsp; Generally, an error is anything that happens during a run of DOTS BIN Validation that causes the service to fail. If an error occurs, an XML error message, similar to the one [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"parent":2349,"menu_order":1,"comment_status":"closed","ping_status":"closed","template":"","meta":{"footnotes":""},"class_list":["post-2847","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v26.2 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>BV - Errors<\/title>\n<meta name=\"description\" content=\"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Error type 4: Domain Specific &nbsp; Generally, an\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.serviceobjects.com\/docs\/dots-bin-validation\/bv-errors\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"BV - Errors\" \/>\n<meta property=\"og:description\" content=\"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Error type 4: Domain Specific &nbsp; Generally, an\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.serviceobjects.com\/docs\/dots-bin-validation\/bv-errors\/\" \/>\n<meta property=\"og:site_name\" content=\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\" \/>\n<meta property=\"article:modified_time\" content=\"2025-08-22T15:42:11+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-bin-validation\/bv-errors\/\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/dots-bin-validation\/bv-errors\/\",\"name\":\"BV - Errors\",\"isPartOf\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#website\"},\"datePublished\":\"2022-11-09T22:24:47+00:00\",\"dateModified\":\"2025-08-22T15:42:11+00:00\",\"description\":\"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Error type 4: Domain Specific &nbsp; Generally, an\",\"breadcrumb\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-bin-validation\/bv-errors\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/www.serviceobjects.com\/docs\/dots-bin-validation\/bv-errors\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/dots-bin-validation\/bv-errors\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"DOTS BIN Validation\",\"item\":\"https:\/\/www.serviceobjects.com\/docs\/dots-bin-validation\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"BV &#8211; Errors\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#website\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/\",\"name\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\",\"description\":\"\",\"publisher\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/www.serviceobjects.com\/docs\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#organization\",\"name\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/\",\"url\":\"https:\/\/www.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png\",\"contentUrl\":\"https:\/\/www.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png\",\"width\":2560,\"height\":1440,\"caption\":\"Service Objects | Contact, Phone, Email Verification | Data Quality Services\"},\"image\":{\"@id\":\"https:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/\"}}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"BV - Errors","description":"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Error type 4: Domain Specific &nbsp; Generally, an","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.serviceobjects.com\/docs\/dots-bin-validation\/bv-errors\/","og_locale":"en_US","og_type":"article","og_title":"BV - Errors","og_description":"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Error type 4: Domain Specific &nbsp; Generally, an","og_url":"https:\/\/www.serviceobjects.com\/docs\/dots-bin-validation\/bv-errors\/","og_site_name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","article_modified_time":"2025-08-22T15:42:11+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-bin-validation\/bv-errors\/","url":"https:\/\/www.serviceobjects.com\/docs\/dots-bin-validation\/bv-errors\/","name":"BV - Errors","isPartOf":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#website"},"datePublished":"2022-11-09T22:24:47+00:00","dateModified":"2025-08-22T15:42:11+00:00","description":"Error Types Error type 1: Authorization Error type 2: User Input Error type 3: Service Objects Fatal Error type 4: Domain Specific &nbsp; Generally, an","breadcrumb":{"@id":"https:\/\/www.serviceobjects.com\/docs\/dots-bin-validation\/bv-errors\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.serviceobjects.com\/docs\/dots-bin-validation\/bv-errors\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.serviceobjects.com\/docs\/dots-bin-validation\/bv-errors\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/www.serviceobjects.com\/docs\/"},{"@type":"ListItem","position":2,"name":"DOTS BIN Validation","item":"https:\/\/www.serviceobjects.com\/docs\/dots-bin-validation\/"},{"@type":"ListItem","position":3,"name":"BV &#8211; Errors"}]},{"@type":"WebSite","@id":"https:\/\/www.serviceobjects.com\/docs\/#website","url":"https:\/\/www.serviceobjects.com\/docs\/","name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","description":"","publisher":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.serviceobjects.com\/docs\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.serviceobjects.com\/docs\/#organization","name":"Service Objects | Contact, Phone, Email Verification | Data Quality Services","url":"https:\/\/www.serviceobjects.com\/docs\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/","url":"https:\/\/www.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png","contentUrl":"https:\/\/www.serviceobjects.com\/docs\/wp-content\/uploads\/2022\/08\/SO-logo-2560px-transparent.png","width":2560,"height":1440,"caption":"Service Objects | Contact, Phone, Email Verification | Data Quality Services"},"image":{"@id":"https:\/\/www.serviceobjects.com\/docs\/#\/schema\/logo\/image\/"}}]}},"_links":{"self":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/2847","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/comments?post=2847"}],"version-history":[{"count":27,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/2847\/revisions"}],"predecessor-version":[{"id":12086,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/2847\/revisions\/12086"}],"up":[{"embeddable":true,"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/pages\/2349"}],"wp:attachment":[{"href":"https:\/\/www.serviceobjects.com\/docs\/wp-json\/wp\/v2\/media?parent=2847"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}