---
title: "Changes to Create a payout"
method: POST
path: "/payouts"
---

# Changes to Create a payout

`POST /payouts`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `c13725f5409c`: 47 breaking, 24 warning, 210 info

## Changes

- **2026-11-03** `c13725f5409c`: 47 breaking, 24 warning, 210 info
  - added the new required request property `paymentInstrument/oneOf[#/components/schemas/PspToken -> subschema #12: PspToken]/psp`
  - added the new required request property `paymentInstrument/oneOf[#/components/schemas/PspToken -> subschema #12: PspToken]/type`
  - added the new required request property `paymentInstrument/oneOf[#/components/schemas/Tokenized -> subschema #14: Tokenized]/token`
  - added the new required request property `paymentInstrument/oneOf[#/components/schemas/Tokenized -> subschema #14: Tokenized]/type`
  - added `#/components/schemas/BankDetails` to the `paymentInstrument/oneOf[subschema #15: TrueLayer]/bankDetails` request property `allOf` list
  - added `#/components/schemas/PspName` to the `psp` request property `allOf` list
  - the request property `paymentInstrument/oneOf[#/components/schemas/PayInReference]/type` became required
  - the request property `paymentInstrument/oneOf[#/components/schemas/PspToken -> subschema #12: PspToken]/token` became required
  - the `paymentInstrument/oneOf[#/components/schemas/PspToken -> subschema #12: PspToken]/token` request property's minLength was increased from `0` to `1`
  - removed `#/components/schemas/BankAccountDetailsIBAN, #/components/schemas/BankAccountDetailsGB` from the `paymentInstrument/oneOf[subschema #15: TrueLayer]/bankDetails` request property `oneOf` list
  - the `paymentInstrument/oneOf[#/components/schemas/Tokenized -> subschema #14: Tokenized]/` request property type changed from no type to `object`
  - the `paymentInstrument/oneOf[subschema #15: TrueLayer]/bankDetails` request property type changed from `object` to no type
  - the `psp` request property type changed from `string` to no type
  - the `recipient/address` request property type changed from no type to `object`
  - the response's body type changed from `object` to no type for status `400`
  - the response's body type changed from `object` to no type for status `500`
  - the response's body type changed from `object` to no type for status `502`
  - the `action` response's property type changed from no type to `object` for status `201`
  - the `action` response's property type changed from no type to `object` for status `422`
  - the `allOf[#/components/schemas/PayoutResponse]/action` response's property type changed from no type to `object` for status `202`
  - the `allOf[#/components/schemas/PayoutResponse]/payoutEligibility/crossBorderGambling` response's property type changed from `string` to no type for status `202`
  - the `allOf[#/components/schemas/PayoutResponse]/payoutEligibility/crossBorderMoneyTransfer` response's property type changed from `string` to no type for status `202`
  - the `allOf[#/components/schemas/PayoutResponse]/payoutEligibility/crossBorderNonMoneyTransfer` response's property type changed from `string` to no type for status `202`
  - the `allOf[#/components/schemas/PayoutResponse]/payoutEligibility/domesticGambling` response's property type changed from `string` to no type for status `202`
  - the `allOf[#/components/schemas/PayoutResponse]/payoutEligibility/domesticMoneyTransfer` response's property type changed from `string` to no type for status `202`
  - the `allOf[#/components/schemas/PayoutResponse]/payoutEligibility/domesticNonMoneyTransfer` response's property type changed from `string` to no type for status `202`
  - the `allOf[#/components/schemas/PayoutResponse]/psp/additionalInfo/oneOf[#/components/schemas/PaysafecardAdditionalInfo]/customerIpAddress` response's property format changed from `ipv4` to no format for status `202`
  - the `allOf[subschema #2]/payoutEligibility/crossBorderGambling` response's property type changed from `string` to no type for status `202`
  - the `allOf[subschema #2]/payoutEligibility/crossBorderMoneyTransfer` response's property type changed from `string` to no type for status `202`
  - the `allOf[subschema #2]/payoutEligibility/crossBorderNonMoneyTransfer` response's property type changed from `string` to no type for status `202`
  - the `allOf[subschema #2]/payoutEligibility/domesticGambling` response's property type changed from `string` to no type for status `202`
  - the `allOf[subschema #2]/payoutEligibility/domesticMoneyTransfer` response's property type changed from `string` to no type for status `202`
  - the `allOf[subschema #2]/payoutEligibility/domesticNonMoneyTransfer` response's property type changed from `string` to no type for status `202`
  - the `payoutEligibility/crossBorderGambling` response's property type changed from `string` to no type for status `201`
  - the `payoutEligibility/crossBorderGambling` response's property type changed from `string` to no type for status `422`
  - the `payoutEligibility/crossBorderMoneyTransfer` response's property type changed from `string` to no type for status `201`
  - the `payoutEligibility/crossBorderMoneyTransfer` response's property type changed from `string` to no type for status `422`
  - the `payoutEligibility/crossBorderNonMoneyTransfer` response's property type changed from `string` to no type for status `201`
  - the `payoutEligibility/crossBorderNonMoneyTransfer` response's property type changed from `string` to no type for status `422`
  - the `payoutEligibility/domesticGambling` response's property type changed from `string` to no type for status `201`
  - …241 more

---

[Operation](https://skmtc.dev/br-dge/apis/br-dge-transaction-rest-api/docs/payouts/post.md) - [API](https://skmtc.dev/br-dge/apis/br-dge-transaction-rest-api.md) - [Page](https://skmtc.dev/br-dge/apis/br-dge-transaction-rest-api/changes/payouts/post)
