---
title: "Changes to Initiate payout"
method: POST
path: "/payment/v2/payouts"
---

# Changes to Initiate payout

`POST /payment/v2/payouts`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 3 revisions.

- **2026-11-06** `c386d436bf2c`: 4 breaking, 5 warning, 4 info
- **2026-06-16** `97d6c0d2fe2e`: 2 breaking, 1 warning, 5 info

## Changes

- **2026-11-06** `c386d436bf2c`: 4 breaking, 5 warning, 4 info
  - removed `#/components/schemas/Individual, #/components/schemas/Company` from the `beneficiary/entity` request property `oneOf` list
  - the `beneficiary/entity/oneOf[#/components/schemas/Individual]/dateOfBirth` response's property format changed from `date` to no format for status `201`
  - the `originator/entity/oneOf[#/components/schemas/Individual]/dateOfBirth` response's property format changed from `date` to no format for status `201`
  - removed the required property `Id` from the response with the `202` status
  - removed the request property `beneficiary/bankAccount/bank/country`
  - removed the request property `beneficiary/bankAccount/intermediaryBanks/items/country`
  - removed the optional property `beneficiary/bankAccount/bank/country` from the response with the `201` status
  - removed the optional property `beneficiary/bankAccount/intermediaryBanks/items/country` from the response with the `201` status
  - added the new `EXPIRED` enum value to the `status` response property for the response status `201`
  - mapped value for discriminator key `COMPANY` changed from `#/components/schemas/Company` to `#/components/schemas/CompanyRequest` for `beneficiary/entity` request property
  - mapped value for discriminator key `INDIVIDUAL` changed from `#/components/schemas/Individual` to `#/components/schemas/IndividualRequest` for `beneficiary/entity` request property
  - added `#/components/schemas/IndividualRequest, #/components/schemas/CompanyRequest` to the `beneficiary/entity` request property `oneOf` list
  - added the required property `id` to the response with the `202` status
- **2026-06-16** `97d6c0d2fe2e`: 2 breaking, 1 warning, 5 info
  - for the `header` request parameter `Idempotency-Key`, the minLength was increased from `3` to `36`
  - the `beneficiary/remittanceInformation` request property's maxLength was decreased to `34`
  - changed the pattern of the request property `beneficiary/remittanceInformation` from `^[A-Za-z0-9.,\-\s]+$` to `^[a-zA-Z0-9\s,.-]{5,34}$`
  - added the media type `application/json` for the response with the status `400`
  - added the media type `application/json` for the response with the status `403`
  - added the non-success response with the status `404`
  - added the non-success response with the status `422`
  - removed the non-success response with the status `401`

---

[Operation](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/payment/v2/payouts/post.md) - [API](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints.md) - [Page](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/payment/v2/payouts/post)