POST
/
partner
/
merchants
Create a merchant (child business) on behalf of the partner
curl --request POST \
  --url https://api.vuz.co.il/api/v1/partner/merchants \
  --header 'Content-Type: application/json' \
  --data '
{
  "partnerExternalRef": "TG-MERCH-001",
  "legalName": "מאפיית האחים בע\"מ",
  "businessType": "osek_murshe",
  "taxId": "514329876",
  "email": "owner@bakery.co.il",
  "tradeName": "מאפיית האחים",
  "phone": "+972501234567",
  "address": "הרצל 123, תל אביב",
  "logoUrl": "https://cdn.togo.co.il/logos/bakery-001.png"
}
'

Body

application/json
​
partnerExternalRef
string
required

Partner's internal merchant ID. Used as the idempotency key. Unique per partner.

Example:

"TG-MERCH-001"

​
legalName
string
required

Legal business name (Hebrew or English). Appears on every invoice.

Example:

"מאפיית האחים בע\"מ"

​
businessType
enum<string>
required

Israeli business type. Drives VAT applicability and document type allowance.

Available options:
osek_patur,
osek_murshe,
limited_company
Example:

"osek_murshe"

​
taxId
string
required

Tax ID — ת.ז. for OSEK_PATUR (9-digit), ע.מ./ח.פ. otherwise. Must pass Israeli checksum.

Example:

"514329876"

​
email
string
required

Owner email. The User record is created dormant — no welcome email is sent.

Example:

"owner@bakery.co.il"

​
tradeName
string

Trade name (public-facing). Defaults to legalName.

Example:

"מאפיית האחים"

​
phone
string

Owner phone in E.164 format

Example:

"+972501234567"

​
address
string

Full street address (single string for MVP)

Example:

"הרצל 123, תל אביב"

​
logoUrl
string

Public URL to the merchant's logo (optional, appears alongside partner branding on the document)

Example:

"https://cdn.togo.co.il/logos/bakery-001.png"

Response

Merchant already exists for this partnerExternalRef