Skip to main content
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

FieldTypeDescriptionRequired
entityIdstringEntity ID from account creationYes
walletTypestringUse USER for end-user walletsYes

​
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.