---
title: "Update Payment Account Status"
method: PUT
path: "/v2/accounts/kycstatus/{accountid}"
tags: ["Accounts | Update"]
---

# Update Payment Account Status

`PUT /v2/accounts/kycstatus/{accountid}`

Allows certain payment account statuses to be updated. 

- To close an account (status 12), the account must have zero balance.  
- An account status can not be changed to bypass the KYC process. KYC statuses are updated by Lemonway.  
- If an account is closed in status 6 (KYC 2) and you would like to reopen it, you must send a support request to Lemonway.  

You can view all account statues [here.](https://documentation.lemonway.com/reference/wallet-status)  

**Note:** This feature is subject to your contract.

## Path parameters

- `accountid` string, required

## Headers

- `Authorization` string, required
- `PSU-Accept-Language` string
- `PSU-IP-Address` string, required
- `PSU-User-Agent` string

## Request body

- UpdateAccountStatusInput
  - `status` 0 | 1 | 2 | 3 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 — New payment account status<br/>0 = Unknown.<br/>1 = Not Opened.<br/>2 = Opened, need more documents.<br/>3 = Opened, document rejected.<br/>5 = Opened, KYC1.<br/>6 = Opened, KYC2.<br/>7 = Opened, KYC3.<br/>8 = Opened, document expired.<br/>9 = Frozen (by backoffice).<br/>10 = Blocked.<br/>11 = Locked (by Web Service).<br/>12 = Closed.<br/>13 = Pending KYC3.<br/>14 = One-time customer.<br/>15 = CGE.<br/>16 = Technical Payment Account.<br/>

## Response `200`

OK

- UpdateAccountStatusOutput
  - `account` UpdateAccountStatus
    - `id` string — Updated payment account ID
    - `status` integer — Status of the payment account
  - `error` Error
    - `code` integer
    - `message` string
    - `psp` PSP
      - `message` string — Get the Error Message from PSP

## Other responses

- `401` — Unauthorized
- `500` — InternalServerError

---

[API](https://skmtc.net/lemonway/apis/account-onboarding-management-api.md) · [All operations](https://skmtc.net/lemonway/apis/account-onboarding-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemonway/account-onboarding-management-api/revisions/73309fe68e2d/schema)