API Errors

Code

Reason

Message

Authentication failed

Could not authenticate user. Make sure you

are using basic auth with your API token as
the username

Disallowed IP

This IP has not been whitelisted. Contact

support to have IP added to whitelist.

Internal Error

Internal issue within BrightSpeed. Wait a

minute and try again.

General Errors
Code

Reason

Message

10

Invalid parameter

View error message for details

11

Missing API requirement

Either a required field is missing or other

parameter requirement has not been met
(such as minimum length). View error
message for additional details.

12

Duplicate record found

Duplicate records are based on custom rules

you provide us. Duplication check is added
upon client request.

13

Record not found

No records found with the given transaction

ID

14

Unauthorized access

Unauthorized attempt to access items

belonging to another user.

Real Time Verification (RTV) Errors, Transaction &

Subscriptions
If an RTV error is received, you should validate the information is correct and try again.
Credentials for success are:
Routing: 000000000
Account: 1111

Code

Reason

Message

20

Real Time Verification

Declined, Invalid Routing

Test credentials for this code:

Routing: 111111111, Account: 1111

21

Real Time Verification

Declined, High Risk Account

Test Credentials for this code:

Routing: 333333333, Account: 1111

22

Real Time Verification

Test Credentials for this code:

Declined, catchall

Routing: 123456789, Account: 1234

Refund Errors
Code

Reason

Message

30

Invalid transaction status for

View errors for details. Only deposited

transactions are eligible for refunds.

refund
31

Invalid refund amount

Refund must be greater than 0 and less than

or equal to the transaction amount.

32

Invalid partial refund

amount

A refund has already been submitted against

this transaction. Verify that the sum total of
refunds does not exceed the total transaction
amount. View error message to see current
sum total.

Subscription Errors
Code

Reason

Message

40

Must specify
trial_period_days

With trial_amount set, you must set

trial_period_days to a value greater than 0

41

Must specify trial_amount

With trial_period_days set, you must specify

the trial amount. For free trials, set to 0.00,
else specify amount for the first charge before
rebilling cycle begins.

42

Salvage, salvage_interval,

With salvage enabled, you must specify a

value over 0 or null for salvage_interval and
salvage_count.

salvage_count are all

required if salvage is enabled
43

Invalid salvage_count

Salvage_count must be less than or equal to 5.

Other Errors
Code

Reason

Message

99

Other

Miscellaneous catchall for other errors that

have not been assigned codes. View errors for
additional details.