Skip to main content

​
Overview

Use this after creating an end-user account. Provide the entityId (account.id) and set walletType: USER to create both USD and NGN wallets.

​
Endpoint

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

​
Request

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

​
Fields

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

​
Response (200)

{
  "message": "Wallets created",
  "wallets": [
    {
      "id": "97500af1-0964-419e-9ed6-3a3aeb1285bc",
      "currency": "NGN",
      "balance": "0",
      "permissions": { "permissionType": "OWNER", "permissionFlowType": "ALL" }
    },
    {
      "id": "af520cb7-5205-4cfb-ab50-ab4802a488fd",
      "currency": "USD",
      "balance": "0",
      "permissions": { "permissionType": "OWNER", "permissionFlowType": "ALL" }
    }
  ]
}

​
Notes

  • Creates both USD and NGN wallets for the entity.
  • For collection vs spend wallets, use the multi-currency retrieval endpoint with type = collection or spend.