logo
Trustly Docs
BETA

Payout Error

Get notified on unsuccessful payouts
Updated 4 days ago

Overview

Only available in production environment


This is a notification that Trustly will send to the merchant's system in order to notify the reason on why a payout has failed.

This notification is not enabled by default. Please contact your Trustly integration manager in case you want to receive it.


A typical scenario is:

  1. A merchant sends an AccountPayout or Withdraw or Refund request to Trustly’s API (and in the case of a Withdrawal, a debit notification is sent to the merchant and the merchant approves the Withdrawal).

  2. Trustly instruct to send the funds to the recipient’s bank account.

  3. As soon as Trustly get notified that the payout cannot be sent or was returned, Trustly will send a "payoutfailed" notification to the NotificationURL specified in the AccountPayout or Withdraw API call, or for a Refund to the NotificationURL from the original Deposit.

Parameters

New parameters may be added to the notification in future versions of the API but current parameters will never be removed.

Example

Example of "payoutfailed" notification JSON RPC HTTPS POST data, sent by the Trustly system to the merchants listening service at the specified NotificationURL:

payoutfailed
{
  "version": "1.1",
  "method": "payoutfailed",
  "params": {
    "signature": "SZth3ylS1[...]5Jm2dnLKtzVq5IRNXBLvh3fO6i1ZCXQ==",
    "data": {
      "currency": "SEK",
      "notificationid": "1716888077",
      "orderid": "3236871181",
      "enduserid": "user_534412",
      "messageid": "483212",
      "amount": "49.90",
      "timestamp": "2019-03-27 10:04:01.446937+01",
	  "errorcode": "incorrect_account_number",
	  "errormessage": "Format of the account number specified is not correct"
    },
    "uuid": "42d7e0a2-03e2-49fc-bcf7-c109fb411514"
  }
}

Response

Valid responses are:

StatusDescription
OKThe notification has been received.


Example

Example of a payout error response:

Response
{
  "result": {
    "signature": "Dd0hjuf17sH0Ku ... S16VbaRzz==",
    "uuid": "42d7e0a2-03e2-49fc-bcf7-c109fb411514",
    "method": "payoutfailed",
    "data": {
      "status": "OK"
    }
  },
  "version": "1.1"
}