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.
    • PaymentDataToBeSigned
    • 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