Skip to main content
Device policy

Create vulnerable device class

POST/v4/config/ows/wallet-provider/individual-wallet-unit-device-policy/vulnerable-device-classes

Adds a vulnerable device class: an Android device model, with all its Android versions or only some. createdBy is the caller. The device policy applies to the Android requests: the registration of a wallet unit, each Wallet Unit Attestation request and each key attestation request. A refused request gets 403 with individual_wallet_unit.device_refused. To revoke the wallet units that are registered on such devices already, run [Scan device policy](/docs/openid4vc-api/config-scan-digital-wallet-open-id-device- policy).

Authorizations

  • Authorizationstringheaderrequired

    Your API key with the prefix ApiKey: ApiKey <your-api-key>. Get an API key.

    Scope:individual-wallet-units:create

Body

application/json

The new vulnerable device class.

  • deviceModelstringrequired

    Required. The manufacturer and the model, exactly as the app sends them in X-Wallet-Device-Model (Build.MANUFACTURER, a space, Build.MODEL).

    1 to 100 characters.

    Example:"samsung SM-A125F"

  • androidVersionsinteger[] | null

    Optional. The major Android versions of the class (1 to 99). Without it, with null or with an empty array: every version.

  • fixedFromPatchLevelstring | null

    Optional. The security update that fixes the class (YYYY-MM). Phones with this security update or a later one are not refused. Without it or with null: no fix.

    Pattern:^(19[7-9][0-9]|[2-9][0-9]{3})-(0[1-9]|1[0-2])$

    Example:"2026-11"

  • reasonstring

    Optional. Why the class is refused.

    At most 1000 characters.

    Example:"Vulnerable TEE firmware (vendor bulletin of October 2026)"

Response

application/json

The new vulnerable device class.

  • vulnerableDeviceClassobject

    A class of Android devices that the wallet provider refuses: a device model, with all its Android versions or only some of them.