Skip to main content
POST
/
embedded
/
api
/
v1
/
wallets
/
business
/
virtual-wallet?orgId=
{orgId}
Create org business virtual wallets
curl --request POST \
  --url 'https://api-dev-embedded.embedly.ng/embedded/api/v1/wallets/business/virtual-wallet?orgId={orgId}' \
  --header 'Content-Type: application/json' \
  --data '
{
  "customLabel": "<string>",
  "businessId": "<string>"
}
'
{
  "data": {
    "statusCode": 201,
    "status": "success",
    "data": {
      "orgId": "string",
      "businessId": "string",
      "accountNumber": "string",
      "accountName": "Account name / customLabel",
      "bankCode": "string",
      "type": "virtual",
      "balance": 0,
      "currency": "NGN",
      "isFrozen": false,
      "walletId": "string",
      "createdAt": "2025-06-16T10:35:22.234Z"
    },
    "message": "Org business virtual Wallet is created successfully"
  },
}

Documentation Index

Fetch the complete documentation index at: https://docs-embeddedfinance.embedly.ng/llms.txt

Use this file to discover all available pages before exploring further.

​
Create Organization’s business virtual wallets

​
customLabel
string
required
Example: “virt”
​
businessId
string
required
Example: “3fa85f64-5717-4562-b3fc-2c963f66afa6”
{
  "data": {
    "statusCode": 201,
    "status": "success",
    "data": {
      "orgId": "string",
      "businessId": "string",
      "accountNumber": "string",
      "accountName": "Account name / customLabel",
      "bankCode": "string",
      "type": "virtual",
      "balance": 0,
      "currency": "NGN",
      "isFrozen": false,
      "walletId": "string",
      "createdAt": "2025-06-16T10:35:22.234Z"
    },
    "message": "Org business virtual Wallet is created successfully"
  },
}