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

# Changes to Create a Payout Request

`POST /api/payouts/payout`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `65aadbefe527`: 7 breaking, 13 warning, 13 info

## Changes

- **2026-11-03** `65aadbefe527`: 7 breaking, 13 warning, 13 info
  - removed the enum value `SOLANA` of the request property `payouts/items/payoutDetails/oneOf[subschema #2: Inline Blockchain Wallet]/walletDetails/blockchain`
  - added `#/components/schemas/KycUpgradeRequiredExceptionBody, #/components/schemas/SignedAgreementRequiredExceptionBody, #/components/schemas/CapabilityNotEnabledExceptionBody, #/components/schemas/KycApprovalRequiredExceptionBody` to the response body `oneOf` list for the response status `403`
  - the response's body type changed from `object` to no type for status `403`
  - removed the required property `errorInstanceId` from the response with the `403` status
  - removed the required property `message` from the response with the `403` status
  - removed the required property `name` from the response with the `403` status
  - removed the required property `params` from the response with the `403` status
  - the `payouts/items/payoutDetails/oneOf[subschema #1: Inline Fiat]/developerFee/allOf[#/components/schemas/DeveloperFee]/developerFeePercentage` request property's max was set to `100.00`
  - the `payouts/items/payoutDetails/oneOf[subschema #3: Counterparty Payout Method]/developerFee/allOf[#/components/schemas/DeveloperFee]/developerFeePercentage` request property's max was set to `100.00`
  - the `payouts/items/payoutDetails/oneOf[subschema #1: Inline Fiat]/developerFee/allOf[#/components/schemas/DeveloperFee]/developerFeePercentage` request property's min was set to `0.00`
  - the `payouts/items/payoutDetails/oneOf[subschema #3: Counterparty Payout Method]/developerFee/allOf[#/components/schemas/DeveloperFee]/developerFeePercentage` request property's min was set to `0.00`
  - removed the request property `payouts/items/payoutDetails/oneOf[subschema #1: Inline Fiat]/fiatAndRailDetails/oneOf[subschema #4: ARS Details]/bankAccountNumberType`
  - added the new `AdditionalRecipientInformationRequired` enum value to the `oneOf[subschema #2: Additional Recipient Information Required]/name` response property for the response status `400`
  - added the new `PayoutComplianceValidationFailedError` enum value to the `name` response property for the response status `428`
  - added the new `PayoutMethodError` enum value to the `name` response property for the response status `412`
  - added the new `PayoutMinimumNotMetError` enum value to the `oneOf[subschema #1: Payout Minimum Not Met Error]/name` response property for the response status `400`
  - added the new `TRON` enum value to the `payouts/items/details/oneOf[subschema #2: Blockchain Payout]/blockchain` response property for the response status `201`
  - added the new `TRON` enum value to the `payouts/items/recipientInfo/oneOf[subschema #2: Inline Payout Recipient Info]/details/oneOf[subschema #2: Inline Blockchain Payout Recipient Details]/blockchain` response property for the response status `201`
  - added the new `mxn-debit-card` enum value to the `payouts/items/details/oneOf[subschema #1: Fiat Payout]/fiatAndRailCode` response property for the response status `201`
  - added the new `usd-el-salvador` enum value to the `payouts/items/details/oneOf[subschema #1: Fiat Payout]/fiatAndRailCode` response property for the response status `201`
  - added the new optional request property `payouts/items/amountV2`
  - added the new optional request property `payouts/items/payoutDetails/oneOf[subschema #2: Inline Blockchain Wallet]/walletDetails/token`
  - the request property `payouts/items/amount` became optional
  - request property `payouts/items/amount` deprecated
  - added the new `TRON` enum value to the request property `payouts/items/payoutDetails/oneOf[subschema #2: Inline Blockchain Wallet]/walletDetails/blockchain`
  - added `#/components/schemas/MxnDebitCardDetails, #/components/schemas/UsdElSalvadorDetails` to the `payouts/items/payoutDetails/oneOf[subschema #1: Inline Fiat]/fiatAndRailDetails` request property `oneOf` list
  - added response discriminator for the response status `400`
  - added response discriminator for the response status `403`
  - added the non-success response with the status `429`
  - removed the `SOLANA` enum value from the `payouts/items/details/oneOf[subschema #2: Blockchain Payout]/blockchain` response property for the response status `201`
  - removed the `SOLANA` enum value from the `payouts/items/recipientInfo/oneOf[subschema #2: Inline Payout Recipient Info]/details/oneOf[subschema #2: Inline Blockchain Payout Recipient Details]/blockchain` response property for the response status `201`
  - added the required property `payouts/items/details/oneOf[subschema #2: Blockchain Payout]/destinationAmount` to the response with the `201` status
  - added the required property `payouts/items/details/oneOf[subschema #2: Blockchain Payout]/token` to the response with the `201` status

---

[Operation](https://skmtc.dev/muralpay/apis/mural-api/docs/api/payouts/payout/post.md) - [API](https://skmtc.dev/muralpay/apis/mural-api.md) - [Page](https://skmtc.dev/muralpay/apis/mural-api/changes/api/payouts/payout/post)