Sign in

v50

latestOpenAPI 3.0.3Apache 2.0raw.githubusercontent.com2026-08-0342108400.9 KB
Payouts

List payouts

Lists payout and payout-deduction records for the specified merchant account within the requested date range.

The response can include:

  • regular payouts (type = PAYOUT)
  • deduction records for refunds, chargebacks, direct debit returns, or balance adjustments

Results are sorted by payout date in the requested order.

get/v1.0/merchants/{merchant_code}/payouts

Path parameters

merchant_codestring required
Example:MH4H92C7

Merchant code of the account whose payouts should be listed.

Query parameters

start_datestring date required
Example:2024-02-01

Start date of the payout period filter, inclusive, in ISO8601 date format (YYYY-MM-DD).

end_datestring date required
Example:2024-02-29

End date of the payout period filter, inclusive, in ISO8601 date format (YYYY-MM-DD). Must be greater than or equal to start_date.

format'json' | 'csv'
Example:json

Response format for the payout list.

limitinteger
Example:10

Maximum number of payout records to return.

order'asc' | 'desc'
Example:desc

Sort direction for the returned payouts.

Response

Returns the list of payout and deduction records for the requested period.

idinteger required

Unique identifier of the payout-related record.

type'PAYOUT' | 'CHARGE_BACK_DEDUCTION' | 'REFUND_DEDUCTION' | 'DD_RETURN_DEDUCTION' | 'BALANCE_DEDUCTION' required

High-level payout record category.

amountnumber float required

Amount of the payout or deduction in major units.

datestring date required

Payout date associated with the record, in YYYY-MM-DD format.

currencystring required

Three-letter ISO 4217 currency code of the payout.

feenumber float required

Fee amount associated with the payout record, in major units.

status'SUCCESSFUL' | 'FAILED' required

Merchant-facing outcome of the payout record.

referencestring required

Processor or payout reference associated with the record.

transaction_codestring required

Transaction code of the original sale associated with the payout or deduction.

Example response

[
  {
    "id": 123456789,
    "type": "PAYOUT",
    "amount": 132.45,
    "date": "2024-02-29",
    "currency": "EUR",
    "fee": 3.12,
    "status": "SUCCESSFUL",
    "reference": "payout-2024-02-29",
    "transaction_code": "TEENSK4W2K"
  }
]