---
title: "FinancialPayout"
description: "A single payout-related record.\n\nA record can represent either:\n- an actual payout sent to the merchant (`type = PAYOUT`)\n- a deduction applied against merchant funds for a refund, chargeback, direct debit return, or balance adjustment"
image: "https://developer.sumup.com/og/index.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://developer.sumup.com/llms.txt
> Use this file to discover all available pages before exploring further.

Path: SumUp REST API

A single payout-related record.

A record can represent either:
- an actual payout sent to the merchant (`type = PAYOUT`)
- a deduction applied against merchant funds for a refund, chargeback, direct debit return, or balance adjustment

## Fields

- `id` (`FinancialPayout.id`; integer, required) — Unique identifier of the payout-related record.
  - format `int64`; example `123456789`
- `type` (`FinancialPayout.type`; string, required) — High-level payout record category.
  - one of `"PAYOUT"`, `"CHARGE_BACK_DEDUCTION"`, `"REFUND_DEDUCTION"`, `"DD_RETURN_DEDUCTION"`, `"BALANCE_DEDUCTION"`; example `"PAYOUT"`
- `amount` (`FinancialPayout.amount`; number, required) — Amount of the payout or deduction in major units.
  - format `float`; example `132.45`
- `date` (`FinancialPayout.date`; string, required) — Payout date associated with the record, in `YYYY-MM-DD` format.
  - format `date`; example `"2024-02-29"`
- `currency` (`FinancialPayout.currency`; string, required) — Three-letter ISO 4217 currency code of the payout.
  - example `"EUR"`
- `fee` (`FinancialPayout.fee`; number, required) — Fee amount associated with the payout record, in major units.
  - format `float`; example `3.12`
- `status` (`FinancialPayout.status`; string, required) — Merchant-facing outcome of the payout record.
  - one of `"SUCCESSFUL"`, `"FAILED"`; example `"SUCCESSFUL"`
- `reference` (`FinancialPayout.reference`; string, required) — Processor or payout reference associated with the record.
  - example `"payout-2024-02-29"`
- `transaction_code` (`FinancialPayout.transaction_code`; string, required) — Transaction code of the original sale associated with the payout or deduction.
  - example `"TEENSK4W2K"`


Source: https://developer.sumup.com/api/schemas/FinancialPayout/index.md
