# Withdraw a Waiting Account

> Coming soon, upon request — this feature is turned on for your tenant by the Aurea team. [Contact us](https://www.aureahub.com/contact)

Withdraw a pay-in account waiting for the user's verification before it opens: nothing had reached the bank ramp.

## Overview

- The request becomes `cancelled` (`nextStep` `ask_again`): ask for the account again with [Open a Virtual Account](https://docs.aureahub.com/docs/payin-initiate.md) when it is wanted.
- The user's own waiting accounts only: any other `requestId` answers `404` `WAITING_ACCOUNT_NOT_FOUND`.

## Endpoint

### `POST /v1/ramp/bank/payin/waiting/{requestId}/cancel`

Authentication: bearer token required.

Withdraws one of the user's waiting pay-in accounts.

**Path parameters**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `requestId` | string (uuid) | yes | The waiting account's `requestId` |

**Responses**

`200` Withdrawn

```json
{
  "waiting": {
    "requestId": "3c5e7a9b-1d2f-4b6a-8c0e-2f4a6c8e0b1d",
    "accountKind": "bank_payin",
    "currency": "EUR",
    "isSandbox": true,
    "status": "cancelled",
    "attempts": 0,
    "lastErrorCode": null,
    "accountId": null,
    "createdAt": "2026-11-06T09:30:00.000Z",
    "closedAt": "2026-11-06T09:41:00.000Z",
    "nextStep": "ask_again"
  }
}
```

`404` Not Found

```json
{
  "statusCode": 404,
  "error": "NotFoundError",
  "message": "No such waiting account of this user",
  "details": { "code": "WAITING_ACCOUNT_NOT_FOUND" }
}
```

**Example request**

```bash
curl -X POST https://api.aureahub.com/v1/ramp/bank/payin/waiting/3c5e7a9b-1d2f-4b6a-8c0e-2f4a6c8e0b1d/cancel \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
```

---

Web version: https://docs.aureahub.com/#payin-waiting-cancel