Update Merchant

> **Private Preview** — Access by request only. The API surface may change before general availability. Contact support@zip.tax for access. Updates an existing merchant. The caller must own the merchant; cross-account modification is blocked. The `update` payload mirrors the create payload — the integrator's external `id` is mutable here.

Private Preview — Access by request only. The API surface may change before general availability. Contact support@zip.tax for access.

Updates an existing merchant. The caller must own the merchant; cross-account modification is blocked. The update payload mirrors the create payload — the integrator’s external id is mutable here.

Authentication

X-API-KEYstring

API Key authentication via header

Request

This endpoint expects an object.

merchantIdstringRequiredformat: "uuid"

Server-issued UUID of the merchant to update

updateobjectRequired

New field values for the merchant. Same shape as the create payload.

Response

statusstring

Operation status

messagestring

Human-readable result message

merchantIdstringformat: "uuid"

Server-issued UUID of the affected merchant

Errors

400

Update Merchant Request Bad Request Error

401

Update Merchant Request Unauthorized Error

403

Update Merchant Request Forbidden Error

404

Update Merchant Request Not Found Error

409

Update Merchant Request Conflict Error

500

Update Merchant Request Internal Server Error

Private Preview — Access by request only. The API surface may change before general availability. Contact support@zip.tax for access.

API Key authentication via header

This endpoint expects an object.

Server-issued UUID of the merchant to update

New field values for the merchant. Same shape as the create payload.

Human-readable result message

Server-issued UUID of the affected merchant

$	curl -X POST https://api.zip-tax.com/merchant/update \
>	-H "X-API-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"merchantId": "merchantId",
>	"update": {
>	"name": "name",
>	"id": "id"
>	}
>	}'

$	curl -X POST https://api.zip-tax.com/merchant/update \
>	-H "X-API-KEY: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"merchantId": "merchantId",
>	"update": {
>	"name": "name",
>	"id": "id"
>	}
>	}'

1	{
2	"status": "status",
3	"message": "message",
4	"merchantId": "merchantId"
5	}