Create wallet unit

POST 
/v2/config/digital-wallet/openid/wallet-provider/wallet-unit

Creates a new wallet unit under the wallet provider for OID4VCI credential issuance and OpenID4VP presentation.

Request

application/json

Body

clientId stringrequired

Client identifier for the new wallet unit (DID or URL).

clientUrl string

URL endpoint of the wallet instance.

clientPublicKey objectrequired

Public key JWK of the wallet instance for cryptographic verification.

isAuthorised boolean

Set to true to authorize this wallet unit upon creation.

Responses

200

Response Headers

application/json

Schema

Schema

walletUnit object

id stringrequired

Unique identifier for the wallet unit record.

clientId stringrequired

Client identifier of the wallet instance, typically a DID or URL. Used to identify the wallet during OID4VCI and OpenID4VP protocol interactions.

clientUrl string

URL endpoint of the wallet instance, used for direct communication.

clientPublicKey objectrequired

Public key JWK of the wallet instance, used to verify Wallet Unit Attestation Proof of Possession.

isAuthorised boolean

When true, this wallet unit is authorized to interact with the Wallet Provider's services.

assertionToken string

Client assertion JWT of the wallet unit, used for OAuth 2.0 client authentication.

assertionTokenType string

Type of the client assertion token.

createdAt number

Unix timestamp (in seconds) when this wallet unit was registered.

updatedAt number

Unix timestamp (in seconds) when this wallet unit record was last modified.

Example (from schema)

{
  "walletUnit": {
    "id": "string",
    "clientId": "string",
    "clientUrl": "string",
    "clientPublicKey": {},
    "isAuthorised": true,
    "assertionToken": "string",
    "assertionTokenType": "string",
    "createdAt": 0,
    "updatedAt": 0
  }
}

401

Unauthorized

Response Headers

application/json

Schema

Schema

errorCode integerrequired
errorDescription stringrequired

Example (from schema)

{
  "errorCode": 400,
  "errorDescription": "Bad input parameter"
}

500

Internal server error

Response Headers

application/json

Schema

Schema

errorCode integerrequired
errorDescription stringrequired

Example (from schema)

{
  "errorCode": 400,
  "errorDescription": "Bad input parameter"
}

Loading...