bitwarden/server · error · BadRequestException
Your tax ID wasn't recognized for your selected country. Ple
Error message
Your tax ID wasn't recognized for your selected country. Please ensure your country and tax ID are valid.
What it means
Error "Your tax ID wasn't recognized for your selected country. Please ensure your country and tax ID are valid." thrown in bitwarden/server.
Source
Thrown at bitwarden_license/src/Commercial.Core/Billing/Providers/Services/ProviderBillingService.cs:593
}
}
try
{
var customer = await stripeAdapter.CreateCustomerAsync(options);
if (!string.IsNullOrEmpty(setupIntentId))
{
await stripeAdapter.UpdateSetupIntentAsync(setupIntentId,
new SetupIntentUpdateOptions { Customer = customer.Id });
}
return customer;
}
catch (StripeException stripeException) when (stripeException.StripeError?.Code == ErrorCodes.TaxIdInvalid)
{
await Revert();
throw new BadRequestException(
"Your tax ID wasn't recognized for your selected country. Please ensure your country and tax ID are valid.");
}
catch
{
await Revert();
throw;
}
async Task Revert()
{
// ReSharper disable once SwitchStatementMissingSomeEnumCasesNoDefault
switch (paymentMethod.Type)
{
case TokenizablePaymentMethodType.BankAccount when !string.IsNullOrEmpty(setupIntentId):
{
await stripeAdapter.CancelSetupIntentAsync(setupIntentId,
new SetupIntentCancelOptions { CancellationReason = "abandoned" });
break;View on GitHub (pinned to e93b962371)
Solutions
- Verify the selected billing country matches the country the tax ID was issued in.
- Re-enter the tax ID in the exact format expected for that country, including the country prefix (e.g. EU VAT numbers).
- Confirm the tax ID is active using your country's official validation service, then resubmit.
- If the ID is valid but still rejected, contact Bitwarden support to update the billing profile.
When it happens
Trigger: Thrown when the submitted tax ID fails validation against the selected country during provider billing setup or update, typically because the tax ID format does not match the country's expected pattern or Stripe tax ID verification rejects it.
Common situations: See trigger scenarios.
AI-assisted analysis of bitwarden/server@e93b962371 (2026-08-13).
Data as JSON: /api/errors/2ec69dec080462f9.
Report an issue: GitHub.