logo
Trustly Docs
BETA

MerchantSettlement

Request a settlement of funds via API
Updated 1 month ago

This API method will initiate a settlement of funds, which will always be sent to the last settlement account for that specific currency.

Note:

The first settlement is required to be done through Trustly Back Office as the receiving bank account needs to be registered before a settlement can be processed.

Request
{
  "method": "MerchantSettlement",
  "params": {
    "Signature": "K5+hjuMqbsH0Ku ... S16VbzRsw==",
    "UUID": "258a2184-2842-b485-25ca-293525152425",
    "Data": {
      "Amount": "800.00",
      "Currency": "EUR",
      "MessageID": "771463386074",
      "Password": "*",
      "Username": "your_username",
      "Attributes": null
    }
  },
  "version": "1.1"
}

The result returned is a hash with the following elements:

Response
{
    "result": {
        "signature": "K47hjudG6sH0Ku ... S16VbzfG8==",
        "uuid": "258a2184-2842-b485-25ca-293525152425",
        "method": "MerchantSettlement",
        "data": {
            "reference": "7653345737",
        }
    },
    "version":"1.1"
}

These error codes can be returned for MerchantSettlement calls. To handle errors, see Error handling.

Error numberError codeDescription
603ERROR_INSUFFICIENT_FUNDSThe amount requested is higher than the balance. Try with a lower amount.
621ERROR_NO_SUITABLE_BANK_ACCOUNT_FOUNDNo settlement has been performed before for this specific currency.