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.