# Freeze a seller.

> A frozen Lite or Relay seller is no longer paid: no automatic payout, no `POST /accounts/{id}/payouts`. What they have stays where it is (their balance in Lite, their dues in Relay), so their refunds and disputes still find it. They keep collecting, so your shop does not break, unless `block_payments` is true: they then collect through nothing, with `403 account_frozen` — a payment, a payment link or an invoice created with `X-Sync`, a part of a shared payment, the activation of a prepared payment, and the charge of any payment made for them before the freeze (`POST /payments/{id}`, its instalments, the payment page). A link or an invoice issued for them before can no longer be paid either. The freeze is read at every charge, with no delay. Refunds go on.

`POST https://api.wajub.com/accounts/{id}/freeze`

A frozen Lite or Relay seller is no longer paid: no automatic payout, no `POST /accounts/{id}/payouts`. What they have stays where it is (their balance in Lite, their dues in Relay), so their refunds and disputes still find it. They keep collecting, so your shop does not break, unless `block_payments` is true: they then collect through nothing, with `403 account_frozen` — a payment, a payment link or an invoice created with `X-Sync`, a part of a shared payment, the activation of a prepared payment, and the charge of any payment made for them before the freeze (`POST /payments/{id}`, its instalments, the payment page). A link or an invoice issued for them before can no longer be paid either. The freeze is read at every charge, with no delay. Refunds go on.

The account's `frozen` says since when, who and why, and its `payout_hold.reason` reads `frozen`. You get `account.frozen`. A freeze Wajub set is Wajub's alone: freezing that seller answers `409 frozen_by_wajub` and changes nothing. Freezing a seller you already froze the same way changes nothing. Sandbox too.

When Wajub freezes a seller you froze, your freeze is kept under Wajub's: the payment block in force is the stronger of the two, and when Wajub lifts its own, yours is back as it was.

Called with your own secret key, never with `X-Sync`; a restricted key is refused.

## Path parameters

- `id` (string, required): The Lite or Relay account `id`.

## Body (application/json)

- `reason` (string, required): Why, 500 characters at most: kept in the account's history and shown in your Dashboard.
- `block_payments` (boolean): Also refuse new payments for this seller. Defaults to `false`.

## Responses

- `200`: OK
- `400`: A Direct account
- `403`: A restricted key
- `404`: Not Found
- `409`: Frozen by Wajub
- `422`: No reason

## Example response (200)

```json
{
  "code": 200,
  "status": "OK",
  "message": "Account frozen",
  "account": {
    "id": "acc_Gt6yU3nE8rM1kS5vX9bQ",
    "account_type": "lite",
    "frozen": {
      "since": "2026-11-20T10:00:00+00:00",
      "by": "platform",
      "reason": "Buyer complaints about undelivered orders",
      "block_payments": false
    },
    "payout_hold": {
      "reason": "frozen",
      "since": "2026-11-20T10:00:00+00:00"
    }
  }
}
```
