Create End User Wallets

A guide for creating multi-currency wallets (USD & NGN) for an end-user entity using their entityId from Account Service.

Endpoint

• POST {{LIQUIDITY_URL}}/v1/ext/wallet/create
• Auth: Bearer {{accessToken}}

Request Body

Field	Type	Description	Required
entityId	string	Entity ID from account creation	Yes
walletType	string	Use USER for end-user wallets	Yes

Example Request

curl -X POST "{{LIQUIDITY_URL}}/v1/ext/wallet/create" \
  -H "Authorization: Bearer {{accessToken}}" \
  -H "Content-Type: application/json" \
  -d '{
    "entityId": "1234567890",
    "walletType": "USER"
  }'

Success Response (200)

{
  "message": "Wallets created",
  "wallets": [
    {
      "id": "97500af1-0964-419e-9ed6-3a3aeb1285bc",
      "slug": "NGN Wallet",
      "currency": "NGN",
      "balance": "0",
      "permissions": { "permissionType": "OWNER", "permissionFlowType": "ALL" },
      "settings": {
        "walletType": "USER",
        "approvalThreshold": 1,
        "displayCurrency": "NGN",
        "fundingCurrencies": ["USD", "NGN"],
        "withdrawalCurrencies": ["USD", "NGN"],
        "showBalance": true
      }
    },
    {
      "id": "af520cb7-5205-4cfb-ab50-ab4802a488fd",
      "slug": "USD Wallet",
      "currency": "USD",
      "balance": "0",
      "permissions": { "permissionType": "OWNER", "permissionFlowType": "ALL" },
      "settings": {
        "walletType": "USER",
        "approvalThreshold": 1,
        "displayCurrency": "USD",
        "fundingCurrencies": ["USD", "NGN"],
        "withdrawalCurrencies": ["USD", "NGN"],
        "showBalance": true
      }
    }
  ]
}

Notes

• Creates both USD and NGN wallets for the specified entity.
• Use walletType: USER for end users; corporate/business wallets may use other types.