Integration FAQ

  1. What is Trustly?
  2. How do consumers pay with Trustly in my web shop?
  3. How do I integrate Trustly?
  4. What kinds of transactions are available with Trustly?
  5. I do not manage to connect to the Trustly test environment, what to do?
  6. I do not manage to connect to the Trustly live environment, what to do?
  7. What is "UUID" and "messageid"?
  8. I'm testing deposits and I'm receiving different amount and currency from what I specified in the deposit call. Why?
  9. Do you have sample code for different languages?
  10. Where to put the Trustly iframe?
  11. How should I present Trustly at my site?
  12. Can I monitor the transactions?
  13. Can I review not completed transactions?
  14. How do I get the funds to my account?

What is Trustly?

Trustly is a fast, simple and secure way for consumers to pay directly from and receive funds directly to their bank account, all without leaving a merchant's website. Consumers simply select their bank, log in with their online bank credentials and confirm the transaction with their preferred authentication method. Trustly currently supports more than 3,300 banks across 29 European markets and its coverage is always growing.
For more information see: trustly.net

How do consumers pay with Trustly in my web shop?

  1. The consumer selects Trustly as payment method in the checkout section.
  2. Your system makes an API call to Trustly’s deposit function where you specify all relevant details for the deposit.
  3. You redirect the consumer to the iframe URL you get in the response from the API-call.
  4. The iframe is shown within your site and the consumer chooses the bank he/she wants to pay from.
  5. The consumer completes the payment within the Trustly iframe.
  6. Your system receives an immediate notification when the consumer has confirmed the payment.
  7. The consumer is redirected to your success URL.

Note: You do not need to care for step 4-5 (above), these steps will be handled within the Trustly iframe, you just need to require the iframe by an API-call and then wait for the credit notification from the Trustly system. See system interaction here for illustration.

How do I integrate Trustly?

API – Full platform integration
Trustly supports full API integration. Basic knowledge of network programming and monetary transactions are required. Any operating system and any programming language can be used to integrate this API.

Module integration
Trustly supports a range of plugins to simplify your integration even further.

What kinds of transactions are available with Trustly?

Deposit – Payments from consumers to merchants are processed in the deposit method through the API.

Refund – Refunds to consumers on a previous payment are done in the refund method through the API.

Withdraw – Payouts from merchants to consumers are done in the withdraw methods through the API.
Note: This method is typically used by wallets but seldom by e-commerce merchants.

Settlement – Settlements from merchants Trustly account to merchants bank account can be done through the Backoffice at any time, or it can be scheduled to run automatically daily, weekly or monthly.

Please see the API Manual for more information

I do not manage to connect to the Trustly test environment, what to do?

  1. Go through this checklist: If you still do not manage to connect, please contact your Trustly account manager.
  2. Have you created the signature keys for the test account and sent the public key to your Trustly account manager?
  3. Do you use the test environment credentials you got from your Trustly account manager?
  4. Have you asked Trustly to white list your current IP-address?
  5. Do you use the URL target: https://test.trustly.com/api/1

If you are receiving an error code from Trustly's API, have a look at this page for more details.

I do not manage to connect to the Trustly live environment, what to do?

  1. Go through this checklist: If you still don’t manage to connect, please contact your Trustly account manager.
  2. Have you created the signature keys for the live account and sent the public key to your Trustly account manager?
  3. Do you use the live environment credentials you got from your Trustly account manager?
  4. Have you asked Trustly to white list your current IP-address?
  5. Do you use the URL target: https://api.trustly.com/1

If you are receiving an error code from Trustly's API, have a look at this page for more details.

What is "UUID" and "messageid"?

UUID - The UUID is unique for each network request.
All requests must have an UUID (Universally unique identifier) assigned to them, this UUID is included in the response to the request along with the name of the method called. A new unique UUID must be generated for each request.

Messageid: MessageID is your unique reference for each transaction.
Difference: UUID is part of the protocol layer, like the signature, they don´t contain any business specific data. Your MessageID on the other hand is probably linked to the consumer’s checkout order so that is business specific.

I'm testing deposits and I'm receiving different amount and currency from what I specified in the deposit call. Why?

In the test environment, Trustly has a built-in test case (D2) which will change the amount in the notifications so that it's different from the amount that you sent in the original deposit request. The reason for this random amount is to emphasize the importance of you reviewing the amount and currency in the credit notification that you are receiving.

Do you have sample code for different languages?

We have example code for PHP, Python and Java. You can find them in theexamples section

Where to put the Trustly iframe?

The Trustly iframe should be integrated in the checkout and opened immediately when consumers choose Trustly as payment method. The Trustly iframe requires 600x600 pixels to work properly. Make sure there is sufficient space in the checkout section.

How should I present Trustly at my site?

There are specific rules for you to apply regarding the presentation of Trustly at your site. Please see Service Presentation Requirements for specifications. Your Trustly integration manager can ask you to make specific changes in these matters.

Can I monitor the transactions?

Yes, to monitor transactions just login to the Trustly Backoffice and go to Orders under the Transactions menu. You can use the Orders view to search and review all payments made by consumers using Trustly. The tool provides additional filer options, enabling you to search for individual transactions, to access a detailed event log of transactions as well as obtain an overview of all transactions made by a particular consumer.

Can I review not completed transactions?

Yes, you can review all payments in the Trustly Backoffice. See Orders under the Transactions menu. You can use the Orders view to search and review all payments made by consumers using Trustly. The tool provides additional filer options, enabling you to search for individual transactions, to access a detailed event log of transactions as well as obtain an overview of all transactions made by a particular consumer.

How do I get the funds to my account?

Payments are sent to your Trustly account which can be accessed though the Trustly back office. Here you can request settlements of the funds to be made to your bank account. They will be manually screened and you will be asked to approve them before settlement is made to ensure you entered the correct bank account number. If you don't want to withdraw your funds manually from the Trustly back office, it's also possible to enable automatic settlements, which can be scheduled to run daily, weekly or monthly.