Marketplace icon

SCA for transaction history

Use our Authentication SDK to authenticate your users before showing them their 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.

Before you begin

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.

To initiate authentication in an Android device:

  1. Initiate the AdyenAuthentication class in your Activity or Fragment.

  2. Check if SCA is available on the device.

    The function returns an sdkOutput.

  3. Pass the sdkOutput to your server.

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.
Request header Description
WWW-Authenticate SCA realm: Transaction.
auth-param1: Base64-encoded value of sdkOutput you get when you initiate authentication.
  1. Use the content of the data array to present the transaction information to your user.