logo
Trustly Docs
BETA
Docs
Get started
Partner integrations

Partner integrations

The purpose of this page is to provide Trustly’s Partners with a high-level overview of the Integration Process in order to ensure an optimal, speedy, “first-time-right” integration between the Partner’s platform and Trustly’s platform.

Code libraries for integrating Trustly's API can be found here.

Please note that unless you are using the Express Merchant On-boarding (see below), every merchant should have a separate Trustly processing account, meaning that the username and password parameters that are used in the API calls will be unique to each merchant. The public/private key can be the same for all merchants as long as the private key is only stored on the Partner's side, and the merchants themselves don't have access to it.

Trustly supports two ways to receive payments from end users:

  • Deposit - allows an end user to make a deposit (pay-in) from their bank account. The merchant makes a deposit call, and our API returns a URL that the merchant should display in an iframe on their site where the end user can then log in to their bank account and approve the payment.

  • Charge - For Trustly Direct Debit (TDD) – See below under “Other Products”. Charge / pull money from an account that has previously been registered with a direct debit mandate.

There are 3 different API methods that can be used to make a pay-out to an end user's bank account.

  • Refund - used when a merchant wants to make a refund for a previous Deposit. Partial refunds are supported, and also multiple refunds on a single deposit as long as the total refund amount does not exceed the original deposit amount.

  • Withdraw - allows an end user to make a withdrawal by selecting their bank account in the Trustly iframe. Mostly used by gaming merchants and e-wallets.

  • AccountPayout - Triggers a payout to a bank account using API calls only (no end user interaction like Withdrawals). Requires an AccountID, which is a unique identifier generated by Trustly for the receiving bank account. Merchants can receive the AccountID in account notification that is sent for Deposit, Withdraw or SelectAccount.