> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cngn.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Temporary Virtual Account

> Create a one-time virtual account for a single customer deposit

Creates a short-lived virtual account tied to a specific expected amount, ideal for checkout flows where each customer payment needs its own account number. The account expires at `expiresAt`.

> [!NOTE]
>
> Requires the **Fiat Deposit** permission. The request body must be [encrypted](https://docs.cngn.co/guides/encryption.md).

### Body parameters (plain payload, pre-encryption)

**amount** `number` *required*

Expected deposit amount in Naira. Minimum `100`.

**customer** `object` *required*

The paying customer.

**properties**

**customer.email** `string` *required*

Customer email address.

**customer.name** `string`

Customer full name.

> [!TIP]
>
> The `customer` object is saved with the account and returned as `metadata` on the [`deposit.received`, `deposit.completed`, and `transaction.failed` webhooks](https://docs.cngn.co/guides/webhooks) for the payment, so you can identify which customer made the transfer.

**accountName** `string`

Custom display name for the account (3–50 characters).

**narration** `string`

Payment narration (max 100 characters).

### Response (decrypted `data`)

**reference** `string`

Your deposit reference.

**paymentReference** `string`

Provider payment reference.

**amount** `number`

Amount the customer should transfer.

**amountExpected** `number`

Total expected including fees.

**fee** `number`

Processing fee.

**vat** `number`

VAT on the fee.

**currency** `string`

`NGN`.

**status** `string`

Deposit status (e.g. `pending`).

**narration** `string`

Narration attached to the account.

**accountNumber** `string`

Temporary NUBAN account number.

**accountName** `string`

Account display name.

**bankName** `string`

Bank hosting the account.

**bankCode** `string`

CBN bank code.

**expiresAt** `string`

ISO 8601 expiry timestamp. Deposits after this time are not credited.

```json Plain body (encrypt before sending) theme={null}
{
  "amount": 50000,
  "customer": {
    "name": "Ada Obi",
    "email": "ada@example.com"
  },
  "accountName": "Acme Checkout",
  "narration": "Order #1042"
}
```

```bash cURL (wire format) theme={null}
curl -X POST "https://api.cngn.co/v1/api/virtual-account/temporary" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "<base64 AES-256-CBC ciphertext of the plain body>",
    "iv": "<base64 16-byte IV>"
  }'
```

```json 200 - Success (data shown decrypted) theme={null}
{
  "status": 200,
  "message": "Temporary virtual account created successfully",
  "data": {
    "reference": "DEP-8c1f2a9b",
    "paymentReference": "PAY-55aa66bb",
    "amount": 50000,
    "amountExpected": 50075,
    "fee": 70,
    "vat": 5,
    "currency": "NGN",
    "status": "pending",
    "narration": "Order #1042",
    "accountNumber": "8801234567",
    "accountName": "Acme Checkout",
    "bankName": "Wema Bank",
    "bankCode": "035",
    "expiresAt": "2026-07-22T18:45:00.000Z"
  }
}
```

```json 400 - Validation error theme={null}
{
  "status": 400,
  "message": "amount: Minimum amount is 100 NGN"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.