Skip to main content
For United States payments, use the Trustly US connector.
Trustly Europe supports redirect-based bank payments for buyers across Europe.

​
Setup

A Trustly account can be requested by contacting their sales team via the Trustly website.

​
Credentials

When setting up Trustly in the dashboard, configure the following credentials, which you can obtain from the Trustly team.
  • Username - The username used to authenticate API requests.
  • Password - The password used to authenticate API requests.
  • Private key - The private key used to sign Trustly requests.

​
Features

Trustly Europe supports the following features:
  • Direct capture - Authorize and capture in a single step
  • Refunds - Refund transactions in full
  • Partial refunds - Refund a portion of a captured transaction
  • Credential verification - Validate configured connector credentials

​
Supported countries

Trustly Europe supports transactions from buyers in the following countries:
Country codeCountry codeCountry codeCountry codeCountry codeCountry codeCountry codeCountry code
ATCZDEDKEEESFIGB
LTLVNLNOPLSE

​
Supported currencies

Trustly Europe supports processing payments in the following currencies:
Currency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency codeCurrency code
AEDAFNALLAMDAOAARSAUDAWG
AZNBAMBBDBDTBHDBIFBMDBND
BRLBSDBWPBZDCADCDFCHFCNY
CRCCUPCVECZKDJFDKKDOPDZD
EGPERNETBEURFJDFKPGBPGEL
GHSGIPGMDGNFGTQGYDHKDHNL
IDRILSINRIQDIRRISKJMDJOD
JPYKESKGSKHRKMFKPWKRWKWD
KYDKZTLAKLBPLKRLRDLYDMAD
MDLMGAMKDMMKMNTMOPMURMVR
MWKMYRMZNNGNNIONOKNPRNZD
OMRPENPGKPHPPKRPLNPYGQAR
RONRSDRUBRWFSARSBDSCRSDG
SEKSGDSHPSOSSRDSYPSZLTHB
TJSTMTTOPTRYTTDTWDTZSUAH
UGXUSDUZSVNDVUVWSTXCDXCG
XPFYERZAR

​
Limitations

The following features are not supported by this connector:
  • Delayed capture - Authorization and capture must happen together
  • Partial capture - Capturing only part of the authorized amount is not supported
  • Void - Voiding authorized transactions is not supported
  • Payment method tokenization - Storing payment methods for recurring use is not supported
  • Create token - Creating standalone payment method tokens is not supported
  • Settlement reporting - Settlement reporting is not supported

​
Required fields

Trustly Europe requires the following checkout fields:
  • Billing address country
  • Billing address line 1
  • Billing address postal code
Optionally, you can pass up to 249 cart items with a transaction.

​
Integration

The default integration for Trustly Europe uses a redirect to a hosted payments page. Start by creating a new transaction with the following required fields. 
var transaction = await client.Transactions.CreateAsync(
  transactionCreate: new TransactionCreate()
  {
    Amount = 1299,
    Currency = "EUR",
    Country = "DE",
    PaymentMethod =
      TransactionCreatePaymentMethod.CreateCheckoutSessionWithUrlPaymentMethodCreate(
        new RedirectPaymentMethodCreate()
        {
          Method = "trustlyeurope",
          RedirectUrl = "https://example.com/callback",
        }
      ),
  }
);
After the transaction is created, the API response includes a payment_method.approval_url and the status is set to buyer_approval_pending. The approval URL expires after 30 minutes. 
{
  "type": "transaction",
  "id": "ea1efdd0-20f9-44d9-9b0b-0a3d71e9b625",
  "payment_method": {
    "type": "payment-method",
    "approval_url": "https://cdn.gr4vy.com/connectors/..."
  },
  "method": "trustlyeurope"
}
Redirect the buyer to the approval_url so they can complete bank authentication and approve the payment. After approval the buyer is redirected to the redirect_url you provided when creating the transaction. Do not rely solely on the redirect - either poll the transaction or (recommended) rely on webhooks to detect the final status (for example capture_succeeded or failure states).