View Categories

Create Wallet

< 1 min read

Create Wallet #

Creates a wallet for an onboarded individual in a specific currency.

Endpoint #

POST https://api-test.10npay.com/api/v1/IndividualWallet/create-wallet

Headers #

  • Authorization: Bearer <access_token>
  • Content-Type: application/json

Request Body #

{
  "individualId": 123,
  "currency": "BGN"
}
Field Description
individualId Identifier returned when the individual record was created. Required.
currency Three-letter ISO currency code (e.g., BGN, EUR). Required.

Response — 200 OK #

{
  "id": 456,
  "currency": "BGN"
}

Errors #

  • 400 Bad Request — invalid currency or wallet already exists.
  • 401 Unauthorized — missing/expired token.
  • 404 Not Found — unknown individualId.
  • 5xx — transient backend error.

Notes #

  • One wallet per currency per individual. Attempting to create an existing wallet returns a validation error.
  • Call this right after the onboarding/KYC flow is finalized to provision the primary wallet.