Docs API

The API is designed to streamline the checkout process by allowing users to easily utilize previously used bank account information at a merchant’s checkout, aiming to enhance payment conversion, decrease transaction time, and encourage repeat usage. The API also offers a list of banks for users to choose from during checkout. Consumers of the API can decide whether to display clickable bank accounts and banks, only banks, or only accounts.

Updated 8 days ago

Overview

A full Azura Core Deposit flow includes these requests:

AzuraDeposit (mandatory)
RemoveAzuraAccount (optional)
Deposit (mandatory)

The AzuraDeposit request provides an Azura SessionID, which must be included in subsequent requests.

AzuraDeposit

The AzuraDeposit request provides checkout components without needing to start an order with Trustly.

Legal requirements

In compliance with legal requirements, if a clickable bank account or bank is presented during the checkout process, it is imperative to prominently display the terms and conditions and privacy policy. This ensures transparency and informs users of their rights and obligations before proceeding with the transaction.

It's important to note that the terms and conditions and privacy policy may vary between countries, as each country may have its own regulations governing these documents. Therefore, it is essential to display the terms and conditions and privacy policy relevant to the country to which the banks and bank accounts belong.

If no bank accounts or banks are presented in the merchant's checkout for selection, it is not necessary to display the terms and conditions and privacy policy.

Request parameters

Request example

AzuraDeposit

{
  "method": "AzuraDeposit",
  "params": {
    "Signature": "f4ThjuMqbsdG6u ... S16VbzD4h==",
    "UUID": "258a2184-2842-b485-25ca-293525152425",
    "Data": {
      "Username": "merchant_username",
      "Password": "merchant_password",
      "MessageID": "your_unique_request_id",
      "Attributes": {
        "Email": "test@trustly.com",
        "MobilePhone": "+46709876543",
        "EndUserID": "12345",
        "Country": "SE",
        "Locale": "sv_SE",
        "Currency": "SEK"
      }
    }
  },
  "version": "1.1"
}

Response attributes

The response provides an object with the following attributes:

Response examples

The response might include an end-user's bank accounts if they have previously used Trustly.

Note: When no accounts are found, the accounts array is empty.

Account found

No account found

{
  "result": {
    "signature": "4F8hjuMqbsH0Ku ... S16VbzRsw==",
    "uuid": "258a2184-2842-b485-25ca-293525152425",
    "method": "AzuraDeposit",
    "version": "1.1",
    "data": {
      "azurasessionid": "a7e1f6e8-67d4-4ea5-8d4b-36dbf6927e8f",
      "accounts":[
       {
        "accountid": "123456789",
        "accountnumbermasked": "**** 392",
        "accountnumberlastdigits": "392",
        "bank": {
          "bankcountry": "SE",
          "bankcode": "SWED",
          "bankname": "Swedbank",
          "banklogoround": "https://asset.trustly.com/assets/se/swed.svg"
        }       
       }
      ],
      "trustlyinfo": {
        "trustlylogo1": "https://assets.trustly.com/black-background-logo.svg",
        "trustlylogo2": "https://assets.trustly.com/white-background-logo.svg",
        "trustlylogo3": "https://assets.trustly.com/green-background-logo.svg",
        "trustlylogo4": "https://assets.trustly.com/no-background-logo.svg"
      },
      "countries": [
        {
          "countrycode": "SE",
          "termsandconditions": {
            "sv": "http://trustly.com/terms/SE/sv.pdf",
            "en": "http://trustly.com/terms/SE/en.pdf"
          },
          "privacypolicy": {
            "sv": "http://trustly.com/privacy/SE/sv.pdf",
            "en": "http://trustly.com/privacy/SE/en.pdf"
          },
          "banks": [
            {
              "bankcountry": "SE",
              "bankcode": "SWED",
              "bankname": "Swedbank", 
              "bankid": "sweden.swed",
              "outoforder": false, 
              "banklogoround": "https://asset.trustly.com/swed_round.svg"
            },
            {
              "bankcountry": "SE",
              "bankcode": "NDEA",
              "bankname": "Nordea",
              "bankid": "sweden.ndea",
              "outoforder": false, 
              "banklogoround": "https://asset.trustly.com/ndea_round.svg"
            }
          ]
        }
      ]
    }
  }
}

{
  "result": {
    "signature": "4F8hjuMqbsH0Ku ... S16VbzRsw==",
    "uuid": "258a2184-2842-b485-25ca-293525152425",
    "method": "AzuraDeposit",
    "version": "1.1",
    "data": {
      "azurasessionid": "a7e1f6e8-67d4-4ea5-8d4b-36dbf6927e8f",
      "accounts":[],
      "trustlyinfo": {
        "trustlylogo1": "https://assets.trustly.com/black-background-logo.svg",
        "trustlylogo2": "https://assets.trustly.com/white-background-logo.svg",
        "trustlylogo3": "https://assets.trustly.com/green-background-logo.svg",
        "trustlylogo4": "https://assets.trustly.com/no-background-logo.svg"
      },     
      "countries": [
        {
          "countrycode": "SE",
          "termsandconditions": {
            "sv": "http://trustly.com/terms/SE/sv.pdf",
            "en": "http://trustly.com/terms/SE/en.pdf"
          },
          "privacypolicy": {
            "sv": "http://trustly.com/privacy/SE/sv.pdf",
            "en": "http://trustly.com/privacy/SE/en.pdf"
          },
          "banks": [
            {
              "bankcountry": "SE",
              "bankcode": "SWED",
              "bankname": "Swedbank", 
              "bankid": "sweden.swed",
              "outoforder": false, 
              "banklogoround": "https://asset.trustly.com/swed_round.svg"
            },
            {
              "bankcountry": "SE",
              "bankcode": "NDEA",
              "bankname": "Nordea", 
              "bankid": "sweden.ndea",
              "outoforder": false, 
              "banklogoround": "https://asset.trustly.com/ndea_round.svg"
            }
          ]
        }
      ]
    }
  }
}

RemoveAzuraAccount

The RemoveAzuraAccount request removes the specified account from Azura. It's optional and doesn't trigger a deposit with Trustly, enabling the removal of the end-user without navigating to the Trustly checkout.

Request parameters

Request example

RemoveAzuraAccount

{
  "method": "RemoveAzuraAccount",
  "version": "1.1",
  "params": {
    "Signature": "f4ThjuMqbsdG6u ... S16VbzD4h==",
    "UUID": "258a2184-2842-b485-25ca-293525152425",
    "MessageID": "your_unique_request_id",
    "Data": {
      "Username": "merchant_username",
      "Password": "merchant_password",
      "MessageID": "your_unique_request_id",
      "Attributes": {
        "AzuraSessionID": "55410fc4-d4f4-4725-b5c6-62131761dc6e",
        "AccountID": "123456789"
      }
    }
  }
}

Response attributes

The response provides an object with the following attributes:

Response example

Account found

No account found

{
  "result": {
    "signature": "4F8hjuMqbsH0Ku ... S16VbzRsw==",
    "uuid": "258a2184-2842-b485-25ca-293525152425",
    "method": "RemoveAzuraAccount",
    "data": {
      "result": "1"
    }
  },
  "version": "1.1"
}

{
  "result": {
    "signature": "4F8hjuMqbsH0Ku ... S16VbzRsw==",
    "uuid": "258a2184-2842-b485-25ca-293525152425",
    "method": "RemoveAzuraAccount",
    "data": {
      "result": "0",
      "rejected": "ERROR_ACCOUNT_NOT_FOUND"
    }
  },
  "version": "1.1"
}

Deposit

The Deposit request starts the deposit process at Trustly. It includes the same parameters as a standard deposit request, along with an additional Azura object containing attributes.

For more details on the deposit request, refer to the Deposit page.

Request parameters

This table lists only the Azura-specific parameters. Refer to the deposit documentation for details on other parameters.

Please ensure that the parameters used in the deposit call exactly match those specified in the corresponding AzuraDeposit call. For instance, if AzuraDeposit was called with 'Country': 'SE' and 'Currency': 'SEK', the deposit call must use the same values.

Request examples

The deposit request must always include the Azura object if an AzuraDeposit method has been called earlier. It can include either an account or a bank to use for the deposit or just start a deposit without preselecting anything.

Deposit with account

Deposit with bank

Deposit without selection

{
  "method": "Deposit",
  "params": {
    "Signature": "f4ThjuMqbsdG6u ... S16VbzD4h==",
    "UUID": "55410fc4-d4f4-4725-b5c6-62131761dc6e",
    "Data": {
      "Attributes": {
        "Azura": {
          "AzuraSessionID": "55410fc4-d4f4-4725-b5c6-62131761dc6e",
          "Action": "SELECT_ACCOUNT",
          "AccountID": "12345678"
        }
      }
    }
  }
}

{
  "method": "Deposit",
  "params": {
    "Signature": "f4ThjuMqbsdG6u ... S16VbzD4h==",
    "UUID": "55410fc4-d4f4-4725-b5c6-62131761dc6e",
    "Data": {
      "Attributes": {
        "Azura": {
          "AzuraSessionID": "55410fc4-d4f4-4725-b5c6-62131761dc6e",
          "Action": "SELECT_BANK",
          "BankID": "sweden.swed"
        }
      }
    }
  }
}

{
  "method": "Deposit",
  "params": {
    "Signature": "f4ThjuMqbsdG6u ... S16VbzD4h==",
    "UUID": "55410fc4-d4f4-4725-b5c6-62131761dc6e",
    "Data": {
      "Attributes": {
        "Azura": {
          "AzuraSessionID": "55410fc4-d4f4-4725-b5c6-62131761dc6e",
          "Action": "NO_SELECTION"
        }
      }
    }
  }
}

Response

The response includes the same data as a standard deposit. For more details on deposit responses, refer to:

https://docs.trustly.com/api/deposit

Error codes

Error Num	Error Code	Description
620	ERROR_UNKNOWN	There could be several reasons for this error, please reach out to your Trustly contact for details.
622	ERROR_INVALID_CURRENCY_CODE	The currency code is invalid. See Currencies page for valid currencies.
623	ERROR_INVALID_PARAMETERS	Some value or parameter in the deposit call does not match the expected format.
737	ERROR_INVALID_COUNTRY	The Country code sent in the API call is invalid.
755	ERROR_INVALID_ACCOUNT_ID	The AccountID sent in the API call is invalid.
759	ERROR_AZURA_SESSION_EXPIRED	The AzuraSessionID has expired. The session is only live for 30 minutes.
760	ERROR_AZURA_ACCOUNT_NOT_FOUND	The AccountID was not found.

Trustly Express API

SelectAccount

Azura Core Deposit

Overview

AzuraDeposit

Request parameters

Request example

Response attributes

Response examples

RemoveAzuraAccount

Request parameters

Request example

Response attributes

Response example

Deposit

Request parameters

Request examples

Response

Error codes

Previous article

Next article