Build an integration for players to deposit money

Before you start

  • Make sure that you have completed Sign up and received a Trustly test account.

Deposit flow

A typical Deposit flow

A typical Deposit flow

In a typical Deposit flow:

  1. Your player enters the amount to deposit in your gaming cashier.
  2. Your system sends an API call to Deposit
  3. Trustly responds with a checkout URL and orderID.
  4. Your system redirects the player to the Trustly checkout where they log in to their bank and authorise the payment.
  5. The player is redirected from the Trustly checkout to the SuccessURL specified in the deposit API call.
  6. Depending on the outcome, Trustly may send any of these notifications:
    1. Pending notification when the player has completed the checkout process.
    2. Credit notification when the player's gaming balance should be credited.
    3. Account notification gives you information about the bank account that is selected by the player.
    4. Debit notification if the deposit transaction fails after the credit is sent.
    5. Cancel notification if the checkout process is interrupted.
  7. You must respond to all notifications immediately.

Note: Account, Pending, Credit notifications can arrive in any order. The Account notification is not enabled by default. If needed, contact Trustly Integration Support.

Step 1: Integrate your system with Trustly

Develop the business logic according to the deposit flow.

  1. Make sure that your integration follows Security requirements.
  2. When players Deposit money, your system calls deposit.
  3. Integrate Trustly Express API.
  4. When Trustly responds with a Trustly URL, your app presents the URL to the player 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. If you have a native app implementation, integrate Trustly SDKs.

Step 2: Design service presentation

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

Step 3: Request acceptance testing

Prior to going live, the Trustly Integration Specialist will perform a series of acceptance testing cases according to Trustly standards, including:

  • Check Deposit API calls parameters and attributes
  • Run built-in test cases (D1-D5 & G1-G3) which are available in the Trustly test checkout
  • Verify that all API notifications are sent with valid responses.
  • Verify user experience of merchant's service presentation

Step 4: Go live

Follow the instructions to go live.