---
title: "Partial Update of a Merchant Entity"
method: PATCH
path: "/entities/{entityUid}"
tags: ["Merchant Maintenance"]
---

# Partial Update of a Merchant Entity

`PATCH /entities/{entityUid}`

A partial update of an existing Merchant Entity. Only replaces the
provided parameters.

This can be used to activate/deactivate a merchant entity and change the trading name.

## Path parameters

- `entityUid` string, uuid, required — The Verifone allocated unique id for this site.

## Request body

- EntityPatch
  - `name` string — A name to be assigned to this entity. This can be the trading name or business name.
  - `status` 'ACTIVE' | 'INACTIVE' — An entity may have different states but will still exist in the Verifone Service without being active as a record is required for the status. This only allows update to active status, delete must be explicity executed as an operation.
  - `merchant` MerchantIdUpdate — Merchant ID rotation — replaces oldMerchantId with newMerchantId on matching entity and PPC records.
    - `oldMerchantId` string, required — The current MerchantId assigned to the entity site and/or PPC. Used as the lookup/match key.
    - `newMerchantId` string, required — The replacement MerchantId to apply wherever oldMerchantId is found.

## Response `204`

Patch Entity Success.

## Other responses

- `400` — Bad Request
- `401` — Unauthorised Request
- `403` — Forbidden Request.
- `404` — Not Found Request
- `429` — Too Many Requests
- `500` — Internal Error
- `503` — Service Not Available
- `504` — Service Timeout

---

[API](https://skmtc.net/verifone/apis/checkout-api.md) · [All operations](https://skmtc.net/verifone/apis/checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/verifone/checkout-api/revisions/ed8dc1f12a5a/schema)