---
title: "Payments Refund/Payout Endpoint max. 1000 Transactions per File."
method: POST
path: "/payments/refundPayout/multi"
tags: ["XS2A.pay"]
---

# Payments Refund/Payout Endpoint max. 1000 Transactions per File.

`POST /payments/refundPayout/multi`

The payout & refund feature with the endpoint multi offers the possibility to initiate a payout or refund that are based on XS2A.pay transactions. Several SEPA pain files can be created that can be processed by your bank.

## Request body

- RefundPayoutMulti
  - `pain_type` 'pain.001.001.03', required — The format of pain file.
  - `batch_booking` boolean
  - `transaction_per_file` integer, required — The minimum value is 100 and the maximum value is 1000.
  - `transactions` RefundPayoutTransactions[], required
    - `transaction` string, required — Internal XS2A transaction id. This id will be the same for the whole transaction.
    - `amount` number, float, required — The amount of a given payout or refund.
    - `type` 'refund' | 'payout', required — The type is payout or refund.

## Response `200`

Request successfully processed

- RefundPayoutMultiResponse
  - `message_ids` string[], required

## Other responses

- `401` — Authentication failed API key missing or not valid
- `403` — Forbidden Access blocked
- `404` — Product not enabled or Not found The requested object does not exist on the server
- `422` — Validation failed Something is wrong with the user input
- `500` — An internal server problem occurred

---

[API](https://skmtc.dev/xs2a/apis/xs2a-api.md) · [All operations](https://skmtc.dev/xs2a/apis/xs2a-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/xs2a/xs2a-api/revisions/ae5fbc5feee3/schema)