---
title: "Changes to Initiate a payout transaction"
method: POST
path: "/payout/{user_token}"
---

# Changes to Initiate a payout transaction

`POST /payout/{user_token}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `f9fa41b7c45c`: 17 breaking, 8 warning, 14 info

## Changes

- **2026-11-03** `f9fa41b7c45c`: 17 breaking, 8 warning, 14 info
  - for the `path` request parameter `user_token`, the minLength was increased from `0` to `36`
  - added the pattern `^(usr_)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$` to the `path` request parameter `user_token`
  - the `attr_set_token` request property's minLength was increased from `0` to `36`
  - the `destination_currency_code` request property's minLength was increased from `0` to `3`
  - the `destination_token` request property's minLength was increased from `0` to `36`
  - the `source_currency_code` request property's minLength was increased from `0` to `3`
  - the `source_token` request property's minLength was increased from `0` to `36`
  - added the pattern `^([a-z]+(_[a-z]+)*_)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$` to the request property `source_token`
  - added the pattern `^(attr_set_)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$` to the request property `attr_set_token`
  - added the pattern `^(dest_)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$` to the request property `destination_token`
  - added the pattern `^[A-Z]{3,5}$` to the request property `destination_currency_code`
  - added the pattern `^[A-Z]{3,5}$` to the request property `source_currency_code`
  - the `oneOf[#/components/schemas/PayoutTxnResp]/attr_set_token` response's property format changed from `uuid` to no format for status `201`
  - the `oneOf[#/components/schemas/PayoutTxnResp]/destination_token` response's property format changed from `uuid` to no format for status `201`
  - the `oneOf[#/components/schemas/PayoutTxnResp]/expiration` response's property format changed from `YYYY-MMDDThh:mm:ss` to `date-time` for status `201`
  - the `oneOf[#/components/schemas/PayoutTxnResp]/payout_token` response's property format changed from `uuid` to no format for status `201`
  - the `oneOf[#/components/schemas/PayoutTxnResp]/source_token` response's property format changed from `uuid` to no format for status `201`
  - for the `path` request parameter `user_token`, the maxLength was set to `40`
  - for the `query` request parameter `limit`, the min was set to `0.00`
  - the `attr_set_token` request property's maxLength was set to `45`
  - the `client_transfer_id` request property's maxLength was set to `50`
  - the `destination_currency_code` request property's maxLength was set to `5`
  - the `destination_token` request property's maxLength was set to `41`
  - the `source_currency_code` request property's maxLength was set to `5`
  - the `source_token` request property's maxLength was set to `45`
  - added the new optional request property `sender_user_token`
  - removed the pattern `^[\d.]+$` from the `query` request parameter `limit`
  - the request property `destination_token` became optional
  - the `attr_set_token` request property format was generalized from `uuid` to no format
  - the `destination_token` request property format was generalized from `uuid` to no format
  - the `source_token` request property format was generalized from `uuid` to no format
  - added the optional property `oneOf[#/components/schemas/PayoutTxnResp]/sender_user_token` to the response with the `201` status
  - the `oneOf[#/components/schemas/PayoutTxnResp]/attr_set_token` response's property pattern `^(attr_set_)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$` was added for the status `201`
  - the `oneOf[#/components/schemas/PayoutTxnResp]/country_code` response's property pattern `^[A-Z]{3}$` was added for the status `201`
  - the `oneOf[#/components/schemas/PayoutTxnResp]/destination_currency_code` response's property pattern `^[A-Z]{3,5}$` was added for the status `201`
  - the `oneOf[#/components/schemas/PayoutTxnResp]/destination_token` response's property pattern `^(dest_)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$` was added for the status `201`
  - the `oneOf[#/components/schemas/PayoutTxnResp]/payout_token` response's property pattern `^(payout_)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$` was added for the status `201`
  - the `oneOf[#/components/schemas/PayoutTxnResp]/source_currency_code` response's property pattern `^[A-Z]{3,5}$` was added for the status `201`
  - the `oneOf[#/components/schemas/PayoutTxnResp]/source_token` response's property pattern `^([a-z]+(_[a-z]+)*_)?[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$` was added for the status `201`

---

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