> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iterapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Merchant — PUT /merchants/{merchantID}

> Update a merchant's name or settings by its UUID. Sends a full replacement of updatable fields. Returns the merchant's UUID on success.

The Update Merchant endpoint modifies an existing merchant's details. Send the fields you want to update in the request body. The endpoint returns the merchant's UUID on a successful update.

**`PUT /merchants/{merchantID}`**

## Authentication

Accepts a Bearer token (`Authorization: Bearer <token>`) or an API key (`X-Api-Key: <key>`).

## Path parameters

<ParamField path="merchantID" type="string" required>
  The UUID of the merchant to update.
</ParamField>

## Request body

<ParamField body="name" type="string">
  The updated display name for the merchant.
</ParamField>

## Response fields

A `200 OK` response is returned on success.

<ResponseField name="id" type="string" required>
  The UUID of the updated merchant.
</ResponseField>

## Example request

```bash theme={null}
curl --request PUT \
  --url https://api.iterapay.com/merchants/b0fcc813-a7ce-4bbc-932f-dbef6f59ca7f \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "My Updated Store"
  }'
```

## Example response

```json theme={null}
{
  "id": "b0fcc813-a7ce-4bbc-932f-dbef6f59ca7f"
}
```

## Error responses

| Status | Description                                                              |
| ------ | ------------------------------------------------------------------------ |
| `400`  | Invalid request body. The `detail` field describes the validation error. |
| `401`  | Missing or invalid credentials.                                          |
| `403`  | Valid credentials but insufficient permissions.                          |
| `404`  | No merchant found with the given `merchantID`.                           |