Skip to main content
Wallet apps

Update wallet app

PUT/v4/config/ows/wallet-provider/individual-wallet-apps/{walletAppId}

Replaces the values of a wallet app. Send the whole app: a member that you leave out is cleared (for example minimumVersion: no minimum). Only the Play Integrity keys work differently: an update without them keeps the stored keys, and an update with both replaces them. The platform of an app does not change.

A new minimumVersion applies to the next signed request: a request with an older X-Wallet-App-Version gets 403 with individual_wallet_unit.app_version_too_old, and the app asks the user to update it.

Authorizations

  • Authorizationstringheaderrequired

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

    Scope:individual-wallet-units:update

Path parameters

  • walletAppIdstring<uuid>required

    The id of the wallet app, from the list of the wallet apps. A deleted app gives 404.

Body

application/json

The new values of the wallet app.

  • namestringrequired

    Required. The name of the app in the dashboard.

    1 to 100 characters.

    Example:"Data Wallet Android"

  • platformenum<string>required

    Required. ios or android. An update cannot change the platform of an app.

    Available options:ios,android

    Example:"android"

  • iosTeamIdstring

    iOS: the Apple Team ID of the developer account, 10 capital letters and digits.

    Example:"8XK2M4Q7ZD"

  • iosBundleIdstring

    iOS: the bundle ID of the app, for example io.igrant.datawallet.

    Example:"io.igrant.datawallet"

  • androidPackageNamestring

    Android: the package name (application ID) of the app, for example io.igrant.datawallet.

    Example:"io.igrant.datawallet"

  • androidSigningCertificateDigestsstring[]

    Android: the SHA-256 digest of the app signing certificate, as the Play Console shows it under App integrity > App signing (the certificate of the Play app signing key). Add another digest only for a build that is signed with another certificate. 64 hexadecimal digits; colons and capital letters are accepted, and the answer has the lowercase form without colons.

    At most 20 items.

  • playIntegrityDecryptionKeystring

    Android: the decryption key of the classic Play Integrity requests of the app, the base64 of an AES-256 key. Get it in the Play Console under App integrity > Play Integrity API > Settings > Classic requests > Manage response encryption keys. Write-only: it is stored encrypted and is never in an answer. Send it together with playIntegrityVerificationKey. An update without the two keys keeps the stored keys.

    Example:"<base64 of the AES-256 decryption key>"

  • playIntegrityVerificationKeystring

    Android: the verification key of the classic Play Integrity requests of the app, the base64 of the DER public key (an EC P-256 key), from the same page of the Play Console. Write-only, as playIntegrityDecryptionKey.

    Example:"<base64 of the DER EC P-256 verification key>"

  • minimumVersionstring

    Optional. The lowest app version (dotted numbers, for example 2026.12.0) that the wallet provider accepts in a signed request. Without it, or with null: no minimum.

    Example:"2026.12.0"

  • androidMinimumVersionCodeinteger

    Optional. Android: the lowest versionCode of the app that the wallet provider accepts. For a release build, the wallet provider compares it with the app version in each Android Key Attestation chain (the registration, a key attestation request and the fresh chain of a Wallet Unit Attestation request), and refuses a lower or missing version with 403 (app_version_too_old). Without it, or with 0: every version. An update without it sets it to 0.

    From 0 to 2100000000.

    Example:2026120001

  • buildenum<string>

    Optional. The build of the app, which decides the device evidence that a request of its wallet units must give. release (the default of a create): every check. development: the wallet provider accepts the App Attest development environment (iOS) and needs no Play Integrity token (Android). simulator: it checks only the request signature. An update without it keeps the stored build. Another value gives 400 (build: must be release, development or simulator).

    Available options:release,development,simulator

    Example:"release"

Response

application/json

The wallet app after the change.

  • walletAppobject

    The wallet app.