增值税号验证 API：在一个 POST 中验证欧盟税号

您向欧洲的企业销售软件。 欧盟税法要求您验证买方的增值税 申请反向收费（0% 增值税）之前的 ID。 官方 VIES 服务的正常运行时间不可靠 并返回 SOAP XML。 您需要一个更快、更安静的替代方案。

波托伊 /v1/validate/vat 端点验证所有 27 个欧盟成员国的增值税号 州和英国。 发送 POST，获取包含有效性、国家/地区代码和 格式化的数字。 没有 XML 解析。 没有 WSDL 文件。 超负荷的政府没有超时 服务器。

API 调用

发送带有两个字母的国家/地区前缀的增值税号：

回复：

这 valid 场是 true 当数字与预期格式匹配时 为了它的国家。 这 country_code 和 country 田野告诉你 该号码属于哪个管辖区。

当号码验证失败时

如果数字与预期模式不匹配， valid 回来了 false。 响应仍然包含检测到的国家/地区：

德国增值税号需要紧随其后的 9 位数字 DE 前缀。 这个有5个。 您的前端可以显示国家/地区名称和预期格式，以帮助用户纠正他们的错误 输入。

Stripe 结账集成

在创建 Stripe 结帐会话之前，请验证买家的增值税 ID。 如果有效，则设置 客户至 tax_exempt: "reverse" 因此 Stripe 收取 0% 的增值税。 如果是 无效，拒绝该表格并要求买家更正。

这可以防止两个常见问题：向应免税的企业收取增值税 （造成退款麻烦），并向使用虚假增值税号的人提供免税 （创建审计问题）。

生成有条件增值税发票

生成发票时，您需要确定增值税税率。 规则：

• 同国B2B销售：收取您的国内增值税税率。
• 使用有效增值税 ID 进行跨境 B2B 销售：适用反向收费 (0%)。
• 增值税 ID 无效或缺失：按买家当地费率收取。

这 country_code API 响应驱动此逻辑：

SaaS B2B 注册表单验证

将增值税号字段添加到您的注册表单并在提交时进行验证。 如果有效，则自动填写 国家/地区下拉列表。 如果无效，则在表单到达后端之前显示错误。

这可以防止不良数据进入您的计费系统。 它还使您的财务团队免于手动 在客户注册并开始使用产品后验证增值税号。

按国家/地区划分的增值税格式

每个欧盟国家都有不同的增值税识别号格式。 API 验证 针对所有这些模式：

完整名单涵盖所有 27 个欧盟成员国以及英国。 格式范围为 8 位数字 （丹麦、卢森堡）到 12 位数字（瑞典）。 有些国家在正文中包含字母 号码（法国、西班牙、爱尔兰）。

格式验证与 VIES 查找

该 API 验证 结构 增值税号。 它确认前缀、长度、 和字符模式符合该国家/地区的规则。 它没有质疑欧盟委员会的 VIES 数据库确认该号码已主动注册。

对于大多数结帐流程，格式验证是正确的第一步。 它捕获错别字、缺失 立即添加前缀和拼凑号码，无需依赖外部服务 经常下来。 如果您还需要注册状态，请在格式检查通过后致电 VIES。 这种两步方法将 VIES 调用减少了 15-30%（所有无效格式都不会命中 服务慢）。

要点

免费套餐涵盖开发和小批量生产使用。 适用于高人流量结账 流中，添加您的 API 密钥 Authorization: Bearer 标头。 检查 API文档 完整的端点参考和 互动游乐场 在浏览器中测试增值税号。