Account & Wallet Usage with Applied Exemptions

Account Usage

1. Restriction Handling for Outdated KYC

When an account is identified as having outdated KYC information (KYC_OUTDATED), Lemonway applies restrictions to ensure ongoing compliance with regulatory requirements.

This situation typically occurs when:

• The verification due date has been reached or passed

1.2 Where this information is available

You can identify this situation through the following channels:

1. Lemonway Dashboard

The account status and restriction details are visible directly in your organisation’s Lemonway Dashboard.

2. GET /accounts

The account will include a requirement indicating a pending KYC update:

{
  "requirements": [
    {
      "id": "6ca90af5-4892-4cfb-b5fe-56b95a85e987",
      "type": "KYC_UPDATE",
      "dueDate": "2026-04-11T18:01:33.908Z",
      "status": "REQUESTED"
    }
  ],
  "restrictions": []
}

3. GET /accounts/{id}

Once restrictions are applied, the response will also include a restriction object:

{
  "requirements": [
    {
      "id": "6ca90af5-4892-4cfb-b5fe-56b95a85e987",
      "type": "KYC_UPDATE",
      "dueDate": "2026-04-11T18:01:33.908Z",
      "status": "REQUESTED"
    }
  ],
  "restrictions": [
    {
      "id": "5690c336-ac61-451c-ae2d-0c02d3748557",
      "category": "KYC",
      "reason": "KYC_OUTDATED",
      "activatedAt": "2026-03-12T19:02:06.269Z",
      "requirementIds": [
        "6ca90af5-4892-4cfb-b5fe-56b95a85e987"
      ]
    }
  ]
}

2.Wallet Usage

2. 1 Restriction Behaviour

2.2 Exception Scenarios