Page tree
Skip to end of metadata
Go to start of metadata



Anything that happens during a run of DOTS Order Validation that causes it to be unable to finish its normal processing is an error. If an error occurs, something similar to the following will result instead of the normal/typical output:


Example:


*Error!*

  <Type>Authorization</Type>
  <TypeCode>1</TypeCode>
  <Desc>Your license key does not work on this service.</Desc>
  <DescCode>8</DescCode>


There are four error types described below.

Error Types



Type

TypeCode

Billable

Standard Across All Gen2 Web Services

Authorization

1

No

Yes

User Input

2

Yes

No

Service Objects Fatal

3

No

Yes

Domain Specific

4

Yes

No



Error type 1: Authorization


These are standard to all Generation 2 DOTS Web Services.

DescCode

Desc

0

Unknown authorization error.

1

Please provide a valid license key for this web service.

2

The daily allowable number of transactions for this license key has been exceeded.

3

The monthly allowable number of transactions for this license key has been exceeded.

4

The total allowable number of transactions for this license key has been exceeded.

5

There are not enough transactions available. Check your daily/monthly transaction limits.

6

This license key has not yet been activated.

7

This license key has expired.

8

Your license key does not work on this service


Error type 2: User Input


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.

DescCode

Desc

1

You must input a license key in the LicenseKey field.

2

TestType is required.

3Invalid Test Type.
4BillingFirstName and BillingLastName are required.
5BillingAddress is required.
6BillingZip is required if both BillingCity and BillingState are not provided.
7ShippingFirstName and ShippingLastName are required.
8ShippingAddress is required.
9ShippingZip is required if both ShippingCity and ShippingState are not provided.
10Invalid input. Please enter a positive integer in the NumberOfItems field.
11Invalid input. Please enter a positive amount in the TransactionTotal field.
12Invalid input. BillingAddressIsResidential and ShippingAddressIsResidential must be either true, false or remain empty.
13Invalid BIN format. Please input a 6 digit BIN.


Error type 3: Service Objects Fatal


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 Email Validation 3 service or a Network/Connectivity issue.

DescCode

Desc

1

Unhandled error. Please contact Service Objects.

Error type 4: Domain Specific


Domain specific errors represent the common errors seen in Service Objects services.

DescCode

Desc

1

Operation Not Supported.

  • No labels