---
title: "Set Account Status"
method: POST
path: "/pws/pws_set_acc_status/"
tags: ["Account"]
---

# Set Account Status

`POST /pws/pws_set_acc_status/`

User passes in account id and a new status to supersede current status. Status descriptions are provided in ac_status field below.
Note: account status is different to card/token status.

## Request body

- SetAccountModel — This web service set the status of an account
  - `ac_id` integer, required — account Number/Identifier.
  - `ac_status` integer, required — <p>The status of the account can be:</p> <ul> <li class="docBullet">0 = Pre-live inactive</li> <li class="docBullet">1 = Live : account is active</li> <li class="docBullet">2 = Payment adjustment</li> <li class="docBullet">3 = Closed</li> <li class="docBullet">4 = Default status</li> <li class="docBullet">5 = Default status - settled</li> <li class="docBullet">6 = Default status - written off</li> <li class="docBullet">7 = Closed debt issue</li> <li class="docBullet">8 = Written off - settled</li> <li class="docBullet">9 = Called back from default (Lawyer)</li> <li class="docBullet">10 = Live but under alert watch (Deprecated)</li><li class="docBullet">11 = Cardholder deceased</li> <li class="docBullet">12 = Current (Blank equivalent)</li> <li class="docBullet">13 = Arrears - active</li> <li class="docBullet">14 = Arrears - blocked</li> <li class="docBullet">30 = Awaiting closure (Deprecated)</li><li class="docBullet">40 = Closed for transactions but still reported (Deprecated)</li><li class="docBullet">50 = Closed, not reported, remaining on system (Deprecated)</li><li class="docBullet">60 = Closed, flagged for removal (Deprecated)</li><li class="docBullet">99 = Suspended</li></ul>
  - `api_call_unique_identifier` string, required — Unique number that must be passed at each API request. Identifier to make each API request unique
  - `client_id` integer, required — Unique identifier for the client which Paymentology will provide at outset
  - `user_id` string — User Id of the Customer who triggered the API request.
  - `remarks` string — Remarks for API request

## Response `200`

Successful Response

- SetAccountStatusResponse — This model contains the response detail of set account status api
  - `header` SetAcccountStatusHeader
    - `error_id` integer — error id
    - `error_desc` string — error message
  - `body` SetAccountStatusBody
    - `ac_status` integer, required — <p>The status of the account can be:</p> <ul> <li class="docBullet">0 = Pre-live inactive</li> <li class="docBullet">1 = Live : account is active</li> <li class="docBullet">2 = Payment adjustment</li> <li class="docBullet">3 = Closed</li> <li class="docBullet">4 = Default status</li> <li class="docBullet">5 = Default status - settled</li> <li class="docBullet">6 = Default status - written off</li> <li class="docBullet">7 = Closed debt issue</li> <li class="docBullet">8 = Written off - settled</li> <li class="docBullet">9 = Called back from default (Lawyer)</li> <li class="docBullet">10 = Live but under alert watch (Deprecated)</li><li class="docBullet">11 = Cardholder deceased</li> <li class="docBullet">12 = Current (Blank equivalent)</li> <li class="docBullet">13 = Arrears - active</li> <li class="docBullet">14 = Arrears - blocked</li> <li class="docBullet">30 = Awaiting closure (Deprecated)</li><li class="docBullet">40 = Closed for transactions but still reported (Deprecated)</li><li class="docBullet">50 = Closed, not reported, remaining on system (Deprecated)</li><li class="docBullet">60 = Closed, flagged for removal (Deprecated)</li><li class="docBullet">99 = Suspended</li></ul>

## Other responses

- `404` — Webservices does not exist
- `500` — Internal Server error

---

[API](https://skmtc.net/paymentology/apis/payapi-docs.md) · [All operations](https://skmtc.net/paymentology/apis/payapi-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paymentology/payapi-docs/revisions/a675891b0365/schema)