v1

latestOpenAPI 3.0.32026-07-243003151.2 MB
Identities

Create Wallet Identity

This API method allows the calling application to create new Wallet Identity for a specific wallet.

post/wallet/{walletId}/identity

Path parameters

walletIdstring string required

EES AIR Wallet ID

Request body

typestring required

Type of the Identity

friendlyNamestring

Identity friendly name

valuestring

Identity value

safeValuestring

Identity safe value (e.g. "original value salted and hashed") - safeValue could then be used in external systems like analytics, referencing original identity, provide uniqueness within a retailer, but without exposing sensitive information like card number.

secretstring

Identity secret

statestring

Identity state

status'ACTIVE' | 'DELETED' | 'INACTIVE' | 'LOST' | 'STOLEN' | 'SUSPENDED' | 'TERMINATED' required

Identity status

Response

Created

identityIdstring required

EES AIR Wallet Identity ID

walletIdstring required

EES AIR Wallet ID

typestring required

Type of the Identity, list of possible enum values could be defined per Client as part of the Onboarding process.

friendlyNamestring required

Wallet Identity friendly name

valuestring required

Wallet Identity value

safeValuestring required

Identity Safe Value (e.g. "original value salted and hashed") - safeValue could be than used in external systems like analytics, referencing original identity, provide uniqueness within a retailer, but without exposing sensitive information like card number.

secretstring required

Wallet Identity secret

statestring required

Wallet Identity state, list of possible values could be defined and set-up per Client during Onboarding process.

status'ACTIVE' | 'DELETED' | 'SUSPENDED' | 'LOST' | 'STOLEN' | 'INACTIVE' required

Identity status

dateCreatedstring date-time required

Date this identity was created

lastUpdatedstring date-time required

Date this identity was last updated

mobileWalletstring required

A url that can be used to add this identity to a mobile wallet (like Apple Wallet and Google Pay)