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

# Update Payment Account Status

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

## Request

- Base URL: `https://ws.lemonway.fr/mb/env-name/prod/directkitrest`
- URL: `https://ws.lemonway.fr/mb/env-name/prod/directkitrest/v2/accounts/kycstatus/{accountid}`
- Auth: none declared. Required headers: `Authorization`, `PSU-IP-Address`

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, required: 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.dev/lemonway/apis/lemonway-directkit-api-2-0.md) - [All operations](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/lemonway/apis/lemonway-directkit-api-2-0/revisions/82551a0a77b8?raw)