---
title: "Changes to Submit Payout"
method: POST
path: "/v3/payouts"
---

# Changes to Submit Payout

`POST /v3/payouts`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 9 of 50 revisions.

- **2026-07-13** `05c3f09fc50a` — 10 breaking, 4 info
- **2022-12-22** `2c03ca69ee09` — 2 info
- **2022-06-27** `1e7a1734a45c` — 4 info
- **2021-01-14** `5e4369698639` — 1 warning, 4 info
- **2020-09-25** `dd71433847a6` — 3 breaking, 18 info
- **2020-06-24** `aded220b0d7b` — 5 info
- **2020-01-28** `1b2abf26b5d6` — 10 breaking, 3 warning, 5 info
- **2019-10-17** `f27462c28e5f` — 7 info
- **2019-07-15** `ced8e167a97c` — 6 breaking, 14 warning, 18 info

## Changes

- **2026-07-13** `05c3f09fc50a` — 10 breaking, 4 info
  - removed the enum value `ACH` of the request property `file/items/transmissionType` (media type: multipart/form-data)
  - removed the enum value `ACH` of the request property `payments/items/transmissionType` (media type: application/json)
  - removed the enum value `LOCAL` of the request property `file/items/transmissionType` (media type: multipart/form-data)
  - removed the enum value `LOCAL` of the request property `payments/items/transmissionType` (media type: application/json)
  - removed the enum value `SAME_DAY_ACH` of the request property `file/items/transmissionType` (media type: multipart/form-data)
  - removed the enum value `SAME_DAY_ACH` of the request property `payments/items/transmissionType` (media type: application/json)
  - removed the enum value `SWIFT` of the request property `file/items/transmissionType` (media type: multipart/form-data)
  - removed the enum value `SWIFT` of the request property `payments/items/transmissionType` (media type: application/json)
  - removed the enum value `WIRE` of the request property `file/items/transmissionType` (media type: multipart/form-data)
  - removed the enum value `WIRE` of the request property `payments/items/transmissionType` (media type: application/json)
  - added the new optional request property `file/items/transactionId` (media type: multipart/form-data)
  - added the new optional request property `payments/items/transactionId` (media type: application/json)
  - the request property `file/items/sourceAccountName` became optional (media type: multipart/form-data)
  - the request property `payments/items/sourceAccountName` became optional (media type: application/json)
- **2022-12-22** `2c03ca69ee09` — 2 info
  - api tag `Payouts` added
  - api tag `Payout Service` removed
- **2022-06-27** `1e7a1734a45c` — 4 info
  - added the new `LOCAL` enum value to the request property `file/items/transmissionType` (media type: multipart/form-data)
  - added the new `LOCAL` enum value to the request property `payments/items/transmissionType` (media type: application/json)
  - added the new `SWIFT` enum value to the request property `file/items/transmissionType` (media type: multipart/form-data)
  - added the new `SWIFT` enum value to the request property `payments/items/transmissionType` (media type: application/json)
- **2021-01-14** `5e4369698639` — 1 warning, 4 info
  - removed the request property `payorId` (media type: application/json)
  - added the new optional request property `file/items/paymentMetadata` (media type: multipart/form-data)
  - added the new optional request property `file/items/remoteSystemId` (media type: multipart/form-data)
  - added the new optional request property `payments/items/paymentMetadata` (media type: application/json)
  - added the new optional request property `payments/items/remoteSystemId` (media type: application/json)
- **2020-09-25** `dd71433847a6` — 3 breaking, 18 info
  - the `errors/items/` response's property type/format changed from ``/`` to `object`/`` for status `400`
  - the `errors/items/` response's property type/format changed from ``/`` to `object`/`` for status `401`
  - the `errors/items/` response's property type/format changed from ``/`` to `object`/`` for status `403`
  - added the optional property `errors/items/errorCode` to the response with the `400` status
  - added the optional property `errors/items/errorCode` to the response with the `401` status
  - added the optional property `errors/items/errorCode` to the response with the `403` status
  - added the optional property `errors/items/errorData` to the response with the `400` status
  - added the optional property `errors/items/errorData` to the response with the `401` status
  - added the optional property `errors/items/errorData` to the response with the `403` status
  - added the optional property `errors/items/localisationDetails` to the response with the `400` status
  - added the optional property `errors/items/localisationDetails` to the response with the `401` status
  - added the optional property `errors/items/localisationDetails` to the response with the `403` status
  - added the optional property `httpStatusCode` to the response with the `400` status
  - added the optional property `httpStatusCode` to the response with the `401` status
  - added the optional property `httpStatusCode` to the response with the `403` status
  - response property `errors/items/locationType` deprecated
  - response property `errors/items/locationType` deprecated
  - response property `errors/items/locationType` deprecated
  - response property `errors/items/reasonCode` deprecated
  - response property `errors/items/reasonCode` deprecated
  - response property `errors/items/reasonCode` deprecated
- **2020-06-24** `aded220b0d7b` — 5 info
  - api operation id `submitPayout` removed and replaced with `submitPayoutV3`
  - api tag `Payout Service` added
  - api tag `Submit Payout` removed
  - added the new optional request property `file/items/transmissionType` (media type: multipart/form-data)
  - added the new optional request property `payments/items/transmissionType` (media type: application/json)
- **2020-01-28** `1b2abf26b5d6` — 10 breaking, 3 warning, 5 info
  - removed the enum value `EUR` of the request property `file/items/currency` (media type: multipart/form-data)
  - removed the enum value `EUR` of the request property `payments/items/currency` (media type: application/json)
  - removed the enum value `GBP` of the request property `file/items/currency` (media type: multipart/form-data)
  - removed the enum value `GBP` of the request property `payments/items/currency` (media type: application/json)
  - removed the enum value `USD` of the request property `file/items/currency` (media type: multipart/form-data)
  - removed the enum value `USD` of the request property `payments/items/currency` (media type: application/json)
  - the `file/items/currency` request property's minLength was increased from `0` to `3` (media type: multipart/form-data)
  - the `payments/items/currency` request property's minLength was increased from `0` to `3` (media type: application/json)
  - added the pattern `^[A-Z]{3}$` to the request property `file/items/currency` (media type: multipart/form-data)
  - added the pattern `^[A-Z]{3}$` to the request property `payments/items/currency` (media type: application/json)
  - the `file/items/currency` request property's maxLength was set to `3` (media type: multipart/form-data)
  - the `payments/items/currency` request property's maxLength was set to `3` (media type: application/json)
  - the `payoutMemo` request property's maxLength was set to `40` (media type: application/json)
  - added the media type `application/json` for the response with the status `400`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - removed the non-success response with the status `404`
  - removed the non-success response with the status `503`
- **2019-10-17** `f27462c28e5f` — 7 info
  - added the new optional request property `payoutFromPayorId` (media type: application/json)
  - added the new optional request property `payoutFromPayorId` (media type: multipart/form-data)
  - added the new optional request property `payoutToPayorId` (media type: application/json)
  - added the new optional request property `payoutToPayorId` (media type: multipart/form-data)
  - the request property `payorId` became optional (media type: application/json)
  - request property `payorId` deprecated (media type: application/json)
  - request property `payorId` deprecated (media type: multipart/form-data)
- **2019-07-15** `ced8e167a97c` — 6 breaking, 14 warning, 18 info
  - added the new required request property `payorId` (media type: application/json)
  - request property `file/items/currency` was restricted to a list of enum values (media type: multipart/form-data)
  - request property `payments/items/currency` was restricted to a list of enum values (media type: application/json)
  - the request property `file/items/sourceAccountName` became required (media type: multipart/form-data)
  - the request property `payments/items/sourceAccountName` became required (media type: application/json)
  - removed the media type `application/json` for the response with the status `400`
  - the `file/items/amount` request property's max was set to `9223372036854775808.00` (media type: multipart/form-data)
  - the `payments/items/amount` request property's max was set to `9223372036854775808.00` (media type: application/json)
  - removed the request property `file/items/paymentMetadata` (media type: multipart/form-data)
  - removed the request property `file/items/remoteSystemId` (media type: multipart/form-data)
  - removed the request property `file/items/transactionId` (media type: multipart/form-data)
  - removed the request property `file/items/transmissionType` (media type: multipart/form-data)
  - removed the request property `payments/items/paymentMetadata` (media type: application/json)
  - removed the request property `payments/items/remoteSystemId` (media type: application/json)
  - removed the request property `payments/items/transactionId` (media type: application/json)
  - removed the request property `payments/items/transmissionType` (media type: application/json)
  - removed the request property `payoutFromPayorId` (media type: application/json)
  - removed the request property `payoutFromPayorId` (media type: multipart/form-data)
  - removed the request property `payoutToPayorId` (media type: application/json)
  - removed the request property `payoutToPayorId` (media type: multipart/form-data)
  - api operation id `submitPayoutV3` removed and replaced with `submitPayout`
  - api tag `Submit Payout` added
  - api tag `Payouts` removed
  - added the new `EUR` enum value to the request property `file/items/currency` (media type: multipart/form-data)
  - added the new `EUR` enum value to the request property `payments/items/currency` (media type: application/json)
  - added the new `GBP` enum value to the request property `file/items/currency` (media type: multipart/form-data)
  - added the new `GBP` enum value to the request property `payments/items/currency` (media type: application/json)
  - added the new `USD` enum value to the request property `file/items/currency` (media type: multipart/form-data)
  - added the new `USD` enum value to the request property `payments/items/currency` (media type: application/json)
  - the `file/items/currency` request property's minLength was decreased from `3` to `0` (media type: multipart/form-data)
  - the `payments/items/currency` request property's minLength was decreased from `3` to `0` (media type: application/json)
  - removed the pattern `^[A-Z]{3}$` from the request property `file/items/currency` (media type: multipart/form-data)
  - removed the pattern `^[A-Z]{3}$` from the request property `payments/items/currency` (media type: application/json)
  - request property `payorId` reactivated (media type: multipart/form-data)
  - added the non-success response with the status `404`
  - added the non-success response with the status `503`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`

---

[Operation](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/docs/v3/payouts/post.md) · [API](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis.md) · [Page](https://skmtc.dev/velopaymentsapi/apis/velo-payments-apis/changes/v3/payouts/post)