Payout webhooks

Txn sends a payout webhook each time a payout's status changes. The payload mirrors the Read payout endpoint response.

The tabs below show example payloads for each status. For the rules that govern transitions, see Payout status flow.

For configuring webhook URLs, retry behaviour, source IPs, and signature verification, see the general Webhooks section.

Status Processing

{
  "data": {
    "attributes": {
      "absorbFees": null,
      "absorbNetworkFee": false,
      "absorbPayoutFee": true,
      "address": "TTbGTMwUwA3mncLP7xqCZei1ekaNSgeAJe",
      "amount": "1000.00",
      "amountCharged": "21.77",
      "amountChargedCurrency": "EUR",
      "createdAt": "2025-07-14T17:30:56.088Z",
      "currency": "TRY",
      "displayFee": "10.00",
      "displayFeeCurrency": "TRY",
      "exchangeRate": "40.636611347206",
      "expiresAt": "2025-07-14T17:31:26.088Z",
      "networkFee": "2.000000",
      "networkFeeCurrency": "USDT",
      "payAmount": "22.608351",
      "payChargeRate": "0.8755286",
      "payChargeRateCurrency": "EUR",
      "payCurrency": "USDT",
      "payNetwork": "ttrx:usdt",
      "payNetworkName": "Tron (TRC20)",
      "paymentMethod": "on_chain",
      "payoutFee": "0.22",
      "payoutFeeCurrency": "EUR",
      "receiverBinanceId": "",
      "reference": "70327e5f-9a3e-4720-b2e4-e899fcbbb956",
      "status": "processing",
      "txid": null
    },
    "id": "e2be6c3c-75cc-4006-983a-afd4e83c7a4b",
    "relationships": {
      "accountCharged": {
        "data": {
          "type": "accounts",
          "id": "13a85b45-8543-41c7-b963-394d4ea128ae"
        }
      },
      "author": {
        "data": {
          "id": "45550837-2dc6-4652-9cbf-bfbe4e16382e",
          "type": "apiKeys"
        }
      }
    },
    "type": "payouts"
  },
  "included": [
    {
      "id": "13a85b45-8543-41c7-b963-394d4ea128ae",
      "type": "accounts",
      "attributes": {
        "master": true,
        "currencyCode": "EUR",
        "label": "master",
        "bankReference": "BDR6421088115176062",
        "balance": "38445.76",
        "totalBalance": "38667.80",
        "currencyType": "fiat"
      },
      "relationships": {
        "company": {
          "meta": {
            "included": false
          }
        },
        "networks": {
          "meta": {
            "included": false
          }
        }
      }
    },
    {
      "attributes": {
        "createdAt": "2024-07-04T16:04:48.187Z",
        "name": "Test Key"
      },
      "id": "45550837-2dc6-4652-9cbf-bfbe4e16382e",
      "type": "apiKeys"
    }
  ],
  "meta": {}
}

Status Completed

Status Cancelled