Accept a payment

Build integration for customers to make one-time payments with Trustly

Before you start

  • Make sure that you have completed Sign up and received a Trustly test account.
  • If you have a native app implementation, integrate Trustly SDKs.

Deposit flow

Use the Deposit API method to accept a payment.


In a typical Deposit flow:

  1. Your customer selects Trustly as the payment option in your webshop.
  2. Your system sends a Deposit request to Trustly's API.
  3. Trustly responds with a URL (The Trustly Checkout URL) and an OrderID which is Trustly's order number.
  4. Your system redirects the customer to the Trustly Checkout URL where they log in to their bank and authorize the payment.
  5. The customer will be redirected from the Trustly checkout to the SuccessURL specified in the Deposit API call.
  6. Depending on the outcome, Trustly may send these notifications:
    • Cancel notification if the payment process is aborted.
    • Pending notification when the customer has completed the payment process in the Trustly Checkout.
    • Account notification to provide you with information about the bank account used for this payment.
    • Credit notification when the transaction is confirmed. This is when you should deliver the ordered goods to the customer.
    • Debit notification if an unexpected error occurs and the money is not received from the customer even after the credit notification is sent.

Note: The pending, credit and account notifications can arrive in any order. The Account notification is not enabled by default. Contact Trustly Integration Support if you would like to receive it.

  1. Your system responds to the received notifications.

Step 1: Integrate your system with Trustly

Develop business logic according to the deposit flow.

  1. Make sure that your integration follows security requirements. See Security.
  2. When a customer chooses Trustly in your checkout, your system calls the Deposit method.
  3. Integrate Trustly Express. See Trustly Express API.
  4. When Trustly's API responds with a URL, your system presents the URL to the customer to select a bank for making the Deposit.
  5. Make sure that your integration logs and handles error codes that are returned from API calls. See Error handling.
  6. Make sure that your integration responds correctly to notifications that Trustly may send out.

Step 2: Design service presentation

When your integration presents a Trustly URL to customers, the presentation must follow Trustly checkout guidelines.

Step 3: Do acceptance testing

Prior to going live, the Trustly Integration Specialist will perform Acceptance testing. Make sure your integration has passed all test cases, including:

  • Deposit API calls
  • Built-in test cases of acceptance testing: D1 to D5, and G1 to G3.
  • Verify that your integration has the correct responses to notifications. See Notification tool.

Step 4: Verify and go live

Follow the instructions to go live.