---
title: "Create Sub Wallet"
method: POST
path: "/sub-wallets"
---

# Create Sub Wallet

`POST /sub-wallets`

## Request body

- object
  - `name` string, required — Wallet name. e.g. NGN Trading
  - `sequenceId` string, required — Unique wallet identifier / idempotency key
  - `currency` string, required — YC Supported fiat currency. e.g. NGN, KES
  - `createVirtualAccount` boolean — When true, creates a virtual bank account linked to the sub-wallet

## Response `201`

Created

- object
  - `id` string
  - `partnerId` string
  - `sequenceId` string
  - `name` string
  - `metadata` object
  - `currency` string
  - `status` string
  - `createdAt` integer
  - `updatedAt` integer
  - `availableBalance` integer
  - `virtualAccount` object
    - `id` string
    - `subwalletId` string
    - `provider` string
    - `currency` string
    - `accountNumber` string
    - `routingNumber` string
    - `accountName` string
    - `bankName` string
    - `bankAddress` string
    - `swiftCode` string
    - `status` string
    - `depositInstructions` object
      - `swift` object
        - `memoTemplate` string
        - `memo` string
        - `bankName` string
        - `accountNumber` string
        - `bic` string
        - `bankAddress` string
    - `virtualAccountType` string
    - `recordType` string
    - `createdAt` string
    - `updatedAt` string

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

---

[API](https://skmtc.net/yellowcard/apis/yellow-cards-payment-api.md) · [All operations](https://skmtc.net/yellowcard/apis/yellow-cards-payment-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yellowcard/yellow-cards-payment-api/versions/516d251059cc/schema)