Partner / Reseller API

Issue Israeli tax-compliant invoices on behalf of many merchants — for aggregators, marketplaces, and delivery platforms.

This section is for resellers/aggregators — a platform that owns many merchant sub-businesses and issues documents on their behalf (/api/v1/partner/*). If you're integrating your own single VUZ business (a store, a plugin, a direct API integration), you want the main Developer API instead — this Partner API is a separate, reseller-only surface and is not the primary path for most integrators.

What you can build

The VUZ Partner API lets enterprise platforms — aggregators, marketplaces, delivery apps, gig-economy services — issue Israeli tax documents on behalf of every merchant on their platform.

You manage the customer relationship. We handle:

חשבונית מס / קבלה generation with full Israeli tax-authority compliance
Sequential document numbering per merchant (audit-grade)
Digital signing (per VAT Circular 24/2004)
PDF rendering, branded with your design
Email + SMS delivery to the end customer
Webhook events for every state change

bolt

Partner Quickstart

Issue your first invoice on behalf of a merchant in 5 minutes.

code

Partner API Reference

Every partner endpoint, every field, every error.

The mental model

Your Platform (e.g. food delivery app)
    │
    │ owns / parents
    ▼
N Merchants  (bakeries, restaurants, ...)        ← regular VUZ Businesses, "Lite" tier
    │
    │ sells to
    ▼
End Customers  (consumers who ordered through your app)

The merchant is the legal issuer of every invoice (their name, ע.מ./ח.פ., business type)
You are annotated as the collecting agent on each document
VUZ signs digitally, handles tax compliance, sends to the end customer
The end customer receives the invoice directly from VUZ infrastructure with your branding

What this is NOT

Not a payment processor. You collect payment your own way (Tranzila, Stripe, cash). We document the transaction.
Not an accounting application. Your merchants don't log into VUZ. The API runs headless on their behalf.
Not a credit-card-on-file vault. D120 credit-card metadata (brand, last 4, installments) is captured for the document, not for re-charging.

Environments

VUZ runs a genuinely isolated sandbox (https://sandbox-api.vuz.co.il) alongside production (https://api.vuz.co.il) — its own database, no shared state with production. Your initial key is issued for whichever environment you request; ask for a vuz_test_* sandbox key to integrate risk-free (no real documents, no real charges, no real messages sent), then request a vuz_live_* production key when you're ready to go live. A key's prefix and its host must match — see the Partner API Reference for details.

Next steps

Get a partner API key

Email partners@vuz.co.il with your platform name. We'll issue your initial key within 1 business day.

Issue your first document

Follow the Partner Quickstart — API key to first signed invoice end-to-end.

Go to production

Once your integration is tested, request a vuz_live_* key. We coordinate the cutover, including IP allowlisting and webhook URL switch.