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

# Update Merchant Status

> Pause or reactivate a merchant's ability to process payments.

### Headers

<ParamField header="x-api-key" type="string" required>
  Your test or live SDK Secret Key (`sk_test_...` or `sk_live_...`).
</ParamField>

### Path Parameters

<ParamField path="id" type="string" required>
  Unique merchant identifier (e.g., `mch_xyz789`).
</ParamField>

### Request Body

<ParamField body="status" type="string" required>
  The new merchant status. Allowed values: `ACTIVE`, `PAUSED`.
</ParamField>

### Response Fields

<ResponseField name="id" type="string">
  Unique merchant identifier.
</ResponseField>

<ResponseField name="name" type="string">
  The merchant's name.
</ResponseField>

<ResponseField name="status" type="string">
  Updated merchant status (`ACTIVE` or `PAUSED`).
</ResponseField>

<ResponseField name="updated_at" type="string">
  ISO 8601 timestamp of update.
</ResponseField>

### Response Example

```json theme={null}
{
  "id": "mch_xyz789",
  "name": "Urban Eats",
  "status": "PAUSED",
  "updated_at": "2026-04-04T15:00:00Z"
}
```

<Warning>
  **Platform Restrictions:** If a merchant has been set to `BLACKLISTED`, `FROZEN`, or `SUSPENDED` by the TapRails platform, you cannot override that status using this endpoint.
</Warning>