Payment-method icon

Trustly payouts

Use Trustly to send payouts your suppliers or users.

To use Trustly to pay out your suppliers or users, first you need to tokenize their bank account details, submit a payout request, and then confirm or decline the payout.

Requirements

Before you can start sending payouts through Trustly, you need to:

  1. Contact our Support Team to enable payouts. Using the Payout API requires additional approval and configuration on our end.
  2. Have an existing integration that accepts Trustly payments. If you haven't integrated yet, refer to our integration guides.

Step 1: Tokenize Trustly payment details

To tokenize Trustly details for payouts, make a POST /payments request. In your request, additionally include:

Parameters Description
amount The value (in minor units) and currency. Set the value to the payment value if you want to tokenize payment details while accepting a payment, or to 0 if you just want to tokenize and save Trustly details for future payouts.
enablePayout Set this to true to tokenize the details for payout.
shopperReference Your unique identifier for the supplier or user.

In the example below, we send a request to tokenize the bank account details of a supplier with shopperReference Supplier_JaneSmith:

When the supplier's bank account details has been saved and tokenized, you receive a webhook containing:

  • eventCode: RECURRING_CONTRACT
  • originalReference: The pspReference of the payment request.

Step 2: Submit a payout request

When you are ready to send a payout, make a POST /submitThirdParty request, specifying the following parameters:

Parameters Description
merchantAccount The merchant account identifier you want to process this payout transaction request with.
amount The value (in minor units) and currency of the payout.
shopperReference The unique identifier for the supplier or user, which matches what you sent when you tokenized their details in the /payments request.
shopperEmail Email address of the supplier or user you are paying out to.
recurring Set this to PAYOUT.
reference Your identifier for this payout request.
selectedRecurringDetailReference Set this to LATEST.
dateOfBirth Date of birth of the supplier or user you are paying out to.
socialSecurityNumber Social security number of the supplier or user you are paying out to.
shopperName Name of the supplier or user you are paying out to.