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

# Create Wallet

> A wallet is a digital account that allows you to transact easily across all frontiers

## Individual Wallet

This endpoint creates a new unique individual wallet for your end user by taking in certain parameters including BVN.

```text [POST] theme={null}
{{baseUrl}}/api/v1/wallet/ngn/create

```

### Header

| Header | Type | Description |
| - | - | - |
| AppId | string | you would need to create an app to get your app ID |
| Authorization | string | Your private (secret) key |

### Body parameter

| Parameter | Type | Description | Required |
| - | - | - | - |
| `first_name` | string | First name | Required |
| `last_name` | string | Last name | Required |
| `middle_name` | string | Middle name | Optional |
| `dob` | string | Date of birth | Required |
| `phone_number` | string | Phone number | Required |
| `bvn` | string | Bank Verification Number | Required |
| `route` | string | Partner bank — `PROVIDUS` or `VFD` | Required |

<Warning>
  The BVN and date of birth you send here are sensitive personal data. Transmit them over HTTPS only, never write them to your application logs, and mask them as `*8901` anywhere a partial value is enough.
</Warning>

### Sample response

```json Response theme={null}
{
  "entity": {
    "wallet_id": "254a14e1-25ac-338a-94ed-9e4041840599",
    "wallet_amount": 0,
    "account_number": "1200335704",
    "phone_number": "08158070522"
  }
}
```

## Corporate Wallet

This endpoint creates a new unique corporate wallet for your end user by taking in certain parameters including BVN.

```text [POST] theme={null}
{{baseUrl}}/api/v1/wallet/ngn/create

```

### Header

| Header | Type | Description |
| - | - | - |
| AppId | string | you would need to create an app to get your app ID |
| Authorization | string | Your private (secret) key |

### Body parameter

| Parameter | Type | Description | Required |
| - | - | - | - |
| `first_name` | string | First name | Required |
| `last_name` | string | Last name | Required |
| `middle_name` | string | Middle name | Optional |
| `dob` | string | Date of birth | Required |
| `phone_number` | string | Phone number | Required |
| `bvn` | string | Bank Verification Number | Required |
| `route` | string | Must be `VFD_CORPORATE` | Required |
| `rc_number` | string | Registration number from CAC | Required |
| `address` | string | Business address | Required |
| `state` | string | Address state | Required |
| `incorporation_date` | string | Date of incorporation | Required |

### Sample response

```json Response theme={null}
{
  "entity": {
    "wallet_id": "254a14e1-25ac-338a-94ed-9e4041840599",
    "wallet_amount": 0,
    "account_number": "1200335704",
    "phone_number": "08158070522"
  }
}
```

## One-time use account

This endpoint creates a One-time use account for your end user by taking in certain parameters.

```text [POST] theme={null}
{{baseUrl}}/api/v1/payment/get_transfer_account

```

### Header

| Header | Type | Description |
| - | - | - |
| AppId | string | you would need to create an app to get your app ID |
| Authorization | string | Your private (secret) key |

### Body parameter

| Parameter | Type | Description | Required |
| - | - | - | - |
| `reference_id` | string | Unique reference identifying the transaction | Required |
| `first_name` | string | First name | Required |
| `last_name` | string | Last name | Required |
| `email` | string | Email address | Required |
| `amount` | int | Amount to fund the account | Required |
| `route` | string | Partner bank — `VFD` | Optional |

### Sample response

```json Response theme={null}
{
  "entity": {
    "account_name": "Pawpaw checkout",
    "account_number": "1234567899",
    "bank_name": "VFD MFB",
    "reference_id": "string-test",
    "transaction_id": "Pila-8981a12c-4a74-400f-b7a1-4e2a042d5c7f",
    "expired_at": "2025-07-17 12:10:30.727620",
    "amount": 10
  }
}
```


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