SCA for transaction history

Each time a user in the European Economic Area (EEA) wants to check their transaction history, you must authenticate them using SCA. To do so:

1. Initiate authentication
2. Initiate a request for your user's transaction history using the sdkOutput that you got when you checked the device eligibility.
3. Authenticate your user with the Authentication SDK.
4. Get the transaction history using the sdkOutput from the authentication step.

Requirements

• Make sure that you have installed the Authentication SDK.
• Make sure that you have registered a device for your user.
• Make sure that your API credential has the following role:
  • TransferService Webservice Retrieve role

Initiate authentication

Before requesting the transaction history, you must initiate the process to authenticate your users.

The following tabs explain how to initiate authentication using Kotlin or Swift.

You will use the sdkOutput when initiating a request for transaction history.

Initiate a request for the transaction history

To request the transaction history for the specified balance account:

1. Make a GET /transactions request, specifying the following parameter in the header:

   Request header	Description
   WWW-Authenticate	SCA realm: Transaction. auth-param1: Base64-encoded value of sdkOutput you get when you initiate authentication..

   Provide the following query parameters:

   Parameter	Description
   balanceAccountId	Unique identifier of the balance account to get the transaction history for.
   createdSince	Only include transactions that have been created on or after this point in time. The value must be in ISO 8601 format. For example, 2022-05-30T15:07:40Z.
   createdUntil	Only include transactions that have been created on or before this point in time. The value must be in ISO 8601 format. For example, 2022-05-31T15:07:40Z.

   The response contains the following field in the header:

   • auth-param1: Base64-encoded blob of data.

   You will need auth-param1 when authenticating your user using the SDK.

2. Pass auth-param1 to the SDK.

Authenticate your user

To authenticate your user with the Authentication SDK:

1. Trigger the SDK and pass the auth-param1 value from the previous step as sdkInput.

2. Pass sdkOutput to your server.

Get the transaction history

To get the transaction history

1. Make a GET /transactions request, specifying the following parameter in the request header.

2. Use the content of the data array to present the transaction information to your user.