Vatgentic

行业专业

即时欧盟增值税验证，使用闪电比特币；每次查询 10 聪；无需订阅。

财税处理

415

下载量

安装量

收藏量

★ 5.0

综合评分ⓘ

概述

更多信息

VatGentic ⚡ Instant VAT Validation#

Lightning-fast EU VAT validation. Lightning payments.

Validate any EU VAT number in seconds. Get company name, address, and validity status.

10 sats per validation (~$0.01). No subscriptions. No signup.

Requirements#

⚠️ You need Lightning Bitcoin to use this service.

Pay via Lightning Network (Bitcoin's payment layer)
Fast, global, no credit cards
Perfect for AI agents and automation

Quick Start#

1. Set the API endpoint#

bash

export VATGENTIC_API_URL="https://fair-earwig.pikapod.net"

2. Validate a VAT number#

python

import requests
import os

# Submit VAT number
response = requests.post(
    f"{os.environ['VATGENTIC_API_URL']}/vat/request",
    json={"vatNumber": "LU26375245", "amountSats": 10}
)
data = response.json()

# Output: Lightning invoice details
print(data)

3. Pay the Lightning invoice#

python

# Invoice from response:
# - bolt11: Lightning invoice string
# - checkout_link: Browser payment
# - amount_sats: 10

# Pay with any Lightning wallet

4. Get your result#

After payment completes, poll for the result:

python

# Poll for completion
import time
for _ in range(15):
    status = requests.get(f"{os.environ['VATGENTIC_API_URL']}/vat/status/{data['request_id']}")
    result = status.json()
    if result['status'] == 'completed':
        print(result['vat_result'])
        break
    time.sleep(2)

API Reference#

Request Validation#

POST /vat/request

bash

curl -X POST $VATGENTIC_API_URL/vat/request \
  -H "Content-Type: application/json" \
  -d '{"vatNumber": "LU26375245"}'

Response:

json

{
  "request_id": "vat_1776348560582_abc123",
  "status": "pending_payment",
  "amount_sats": 10,
  "bolt11": "lnbc100n1p5xyz...",
  "checkout_link": "https://pay.example.com/i/abc123"
}

Check Status#

GET /vat/status/{request_id}

bash

curl $VATGENTIC_API_URL/vat/status/vat_1776348560582_abc123

Response (completed):

json

{
  "status": "completed",
  "vat_result": {
    "valid": true,
    "country_code": "LU",
    "company_name": "Example S.à r.l.",
    "company_address": "123 Rue Example, Luxembourg"
  }
}

Pricing#

10 sats per validation (~$0.01 USD)

Lightning Network only. Fast, private, global.

Example: Agent Integration#

python

import requests, os, time

def validate_vat(vat_number):
    """Validate VAT and return company details."""
    url = os.environ['VATGENTIC_API_URL']

    # Submit request
    resp = requests.post(f'{url}/vat/request',
                         json={'vatNumber': vat_number})
    req = resp.json()

    # Pay invoice (manual or automated via Lightning wallet)
    print(f"Pay {req['amount_sats']} sats: {req['checkout_link']}")

    # Wait for completion
    for _ in range(15):
        status = requests.get(f"{url}/vat/status/{req['request_id']}")
        result = status.json()
        if result['status'] == 'completed':
            return result['vat_result']
        time.sleep(2)

    raise TimeoutError("Validation timeout")

# Use it
company = validate_vat("LU26375245")
print(f"✅ Valid: {company['valid']}")
print(f"📦 {company['company_name']}")