Aera Wallets API

Bugfix:

• Made sure to always populate the field sessionExpirationTime when WLW is calling the WSP endpoint: Process WLW transaction init request

Aera Wallets SDK

Aera Wallets API

• New WSP wallet management endpoints
  • Get Payment Instruments in wallet
  • Delete a payment instrument from a Wallet
• Updated response body for Get Wallet details
• New query parameters for Get Wallet details
  • includeSDKInfo = When set to true this will populate the list sdkIds with the id of all the SDKs associated with this wallet.
  • includeUserInfo = When set to true this will populate the userInfo field.
• Other small improvements
  • No longer require the field identityTrustAnchor on Create Xtra Payment Instrument.
  • Sending WSP events when onboarding an XTRA payment instrument.
  • Expanded the data field within the WSP events for payment instrument onboarding to include:
    • maskedPan
    • nickname
  • Now sending WSP events both when a consumer or WSP delete a single payment instrument from a wallet.

📘

For developers, read API version log for more details.

Aera Wallets SDK

• Android Wallets SDK for iOS is now available for staging! The functionality includes the partial Wallets SDK flow for open wallet and payment. The Wallets SDK documentation has been updated to include iOS specifics, and should be revisited.
• Merchant Specific Preferences: Android and iOS: A Config parameter is now available to send currently selected language from Membership App to the rest of the wallet.

See code related changes in the SDK Version Log

Aera Wallets API

New page for response codes

Response codes

Updated demo PSP headers

Added the following headers, to make the demo PSP even more similar to the actual PSP:

• idempotency-key

❗️

The DemoPSP must be treated as what it is; a demo application. Changes in the API definitions may still be needed to successfully integrate towards the real Aera PSP.

New request body examples for transactions

Request examples

Updated request/response examples in API Reference for each endpoint

• DemoPSP
• DemoWSP
• WspWalletsManagement
• SessionManagement

Duplicate validation

• Consumers will no longer be able to onboard the same MONIZZE account (duplicates) multiple times to the same wallet. The same MONIZZE account can still be onboard to multiple wallets.
• Duplicate XTRA accounts, with the same IBAN can't be onboard to the same wallet. The same XTRA account can still be onboard to multiple wallets.

New Session details endpoint

See Wallet Session Management for more details. You can find the API specifications here.

Aera Wallets SDK

• Success and error types Updated and improved
• WalletCallback now requires success return model as type
• Merchant Specific preferences Branding is now supported by the Wallets Dashboard based on WSP Config. Updated preferences/configurations information.
• Security section improved. Will be updated further for later releases.

New SDK Version 2025.11.00 available Hybrid payment and other improvements from 2025.10.00-2025.11.00 are now available in the Android Wallets SDK. Update the Secure ID SDK as well, distributed together with the Wallets SDK.

See code related changes in the SDK Version Log

Aera Wallet API

WSP Management API

• New endpoint for onboarding XTRA payment instruments

New transaction status

• SIGNED = Consumer has signed transaction and it is no longer possible to cancel the transaction. See Transactions.

Breaking changes

• Explicitly clarifying expectations related to normal handling of Aera Wallet API.

Aera Wallets SDK

• Hybrid payment updates since 2025.10.00:
  • Definitions updated
    • PaymentInstrument: Currency added
    • PaymentData/PaymentResult:
      • TBS/PaymentDataToBeSigned removed. Relevant fields moved up to PaymentData/PaymentResult.
      • OrderId added
      • TransactionType added
    • DPA format/localize/translate responsibilities noted

Aera Wallets API

WLW ➡️ WSP integration changes

• Changed field(s) in Process WLW transaction init request
  • sessionId within the session object was always equal to the field transactionId. To be consistent, we have removed the field transactionId, meaning you should rely on sessionId within the session object.
  • Removed status field.
• Change field Process WLW transaction result request.
  • transactionId ➡️ sessionId
• Change field in Process WLW events:
  • In the data field you have been able to expect a transactionId when receiving transaction events, this field has now changed to sessionId. See example event in WSP Events table.

ECR ➡️ PSP integration changes

• New endpoints that will replace old endpoints:
  • Wallet sale
  • Wallet hybrid sale
  • Get transaction status
  • Cancel transaction

Aera Wallets SDK

• Hybrid payment updates:
  • Methods
    • SignPaymentData in method signPayment is now optional, as instruments can be preselected before payment UI display and consumer approval.
  • Definitions updated
    • PaymentData
    • AmountDetails removed. TransactionDetails added.
    • SignPaymentData
    • New model "PaymentResult" for transaction feedback
    • PaymentInstrument

Aera Wallets API 2025.09.00

• Now support use of DYNAMIC_SDKID when initiating transactions towards Aera demo PSP.

Aera Wallets SDK 2025.09.00

For code changes directly applicable to the SDK, see SDK Version log

• SDK Methods
  • Generic: Add getDynamicSDKId method
  • Partial flow: signPayment arguments data and callback switched place
• Definitions
  • SDKInfo now includes walletsSDKVersion and secureIdSDKVersion
• Success and Error types
  • Add error types SID_GENERAL_ERROR and SID_NOT_INITIALIZED_ERROR.
  • Update error type NETWORK_ERROR to NETWORK_GENERAL_ERROR

Documentation changes

Aera Wallets API

For code changes directly applicable to the SDK, see Wallet Infrastructure Version log

• WSP Events
  • Have been implemented. See page "WSP Events" for examples, as well as what type of events you can expect at this time.
• Wallet management
  • New endpoint for deleting single SDK (see API reference).
• Transactions
  • New endpoint in demo PSP for canceling a transaction (see API reference).
  • New field sent to transaction-init and transaction-result requests: status = transactions status. See page "Transactions" for details about each possible status.

Aera Wallets SDK 0.3.0

For code changes directly applicable to the SDK, see SDK Version log

• SDK Methods

  • Generic: Add getSDKInfo method
  • Partial flow: Add cancelPayment method
  • IWebAppInterface: Update code example including import statements and handling for updated back navigation

• Sequence diagrams

  • Add “cancelPayment” SDK method sequence diagram
  • Add related cancellation sequence diagrams.

• Google Play Integrity API

  • Update import statements, signatures and code implementation example
  • Update procedure settings and JSON example

• Success and Error types

  • Add error types SIGN_DATA_ERROR, ACTION_NOT_SUPPORTED, FORMAT_ERROR and GENERAL_ERROR.
  • Add success type GET_SDK_INFO_SUCCESS. Update USER_CLOSED_PAYMENT_DIALOG to include cancellation from UI/POS.

• Definitions

  • New model “SDKInfo”

• General edits

  • Minor updates to wording and updates to names for consistency
    • DPA -> Mobile App
    • DPA BE -> Mobile App Backend
    • ECR/POS -> Merchant Store
    • WSP/MobilePay -> Wallet Provider
    • SID SDK -> Secure ID SDK
  • Restructure pages for simpler navigation

ID explanations

We have included extended explanations on two Ids in the Wallet environment for you to have a deeper knowledge of. These can be found here:

1. FixedSDKId = sdkId
2. SubjectId = Subject / sub

Descriptions for new flows: standard flow for payments, and partial flows for open wallet and payments.

New sequence diagrams.

New sections

• Standard flow vs. partial flow
• Methods: Common
• Methods: Partial flow
• Models

Edited sections

• Concepts
• Context diagram
• Merchant specific preferences
• Methods: Standard flow
• Data flows

SDK Version log