---
title: "FinancialPayouts"
description: "Ordered list of payout and payout-deduction records."
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

Ordered list of payout and payout-deduction records.

## Fields

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