Create wallet app
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
AuthorizationstringheaderrequiredYour API key with the prefix
ApiKey:ApiKey <your-api-key>. Get an API key.Scope:
individual-wallet-units:create
Body
The new wallet app.
namestringrequiredRequired. The name of the app in the dashboard.
1 to 100 characters.
Example:
"Data Wallet Android"platformenum<string>requiredRequired.
iosorandroid. An update cannot change the platform of an app.Available options:
ios,androidExample:
"android"iosTeam Id stringiOS: the Apple Team ID of the developer account, 10 capital letters and digits.
Example:
"8XK2M4Q7ZD"iosBundle Id stringiOS: the bundle ID of the app, for example
io.igrant.datawallet.Example:
"io.igrant.datawallet"androidPackage Name stringAndroid: the package name (application ID) of the app, for example
io.igrant.datawallet.Example:
"io.igrant.datawallet"androidSigning Certificate Digests string[]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.
playIntegrity Decryption Key stringAndroid: 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>"playIntegrity Verification Key stringAndroid: 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>"minimumVersion stringOptional. The lowest app version (dotted numbers, for example
2026.12.0) that the wallet provider accepts in a signed request. Without it, or withnull: no minimum.Example:
"2026.12.0"androidMinimum Version Code integerOptional. Android: the lowest
versionCodeof the app that the wallet provider accepts. For areleasebuild, 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 with403(app_version_too_old). Without it, or with0: every version. An update without it sets it to0.From 0 to 2100000000.
Example:
2026120001buildenum<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 gives400(build: must be release, development or simulator).Available options:
release,development,simulatorExample:
"release"
Response
The new wallet app, with its ready state.
walletApp objectThe wallet app.