Skip to main content
Wallet apps

Create wallet app

POST/v4/config/ows/wallet-provider/individual-wallet-apps

Adds an iOS or Android app of the wallet solution (source interface). The wallet provider registers a wallet unit only for an app that is ready, and it checks the app identity of each request against the apps: the App ID of the App Attest attestation (iOS), or the package name and a signing certificate digest of the Android Key Attestation chain (Android). An app can be saved before it is ready: notReadyReason says what is missing.

For an Android app, copy the Play app signing certificate digest and the two Play Integrity keys of the classic requests from the Play Console. The keys are write-only: they are stored encrypted and never returned.

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 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 new wallet app, with its ready state.

  • walletAppobject

    The wallet app.