---
title: "Changes to Create a payment"
method: POST
path: "/v1/payments"
---

# Changes to Create a payment

`POST /v1/payments`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 6 of 13 revisions.

- **2026-08-27** `9d4ba1cc037c` — 1 breaking, 3 warning, 3 info
- **2026-07-12** `0d036504e049` — 2 info
- **2026-06-07** `bb5bf9a20957` — 1 info
- **2026-05-10** `c1963c0f2a87` — 6 info
- **2026-04-14** `74ad5da44cf9` — 4 breaking, 14 warning, 3 info
- **2026-04-14** `c75657100757` — 1 info

## Changes

- **2026-08-27** `9d4ba1cc037c` — 1 breaking, 3 warning, 3 info
  - the `error` response's property type/format changed from `object`/`` to `string`/`` for status `409`
  - removed the optional property `error/code` from the response with the `409` status
  - removed the optional property `error/details` from the response with the `409` status
  - removed the optional property `error/message` from the response with the `409` status
  - added the optional property `code` to the response with the `409` status
  - added the optional property `message` to the response with the `409` status
  - added the optional property `statusCode` to the response with the `409` status
- **2026-07-12** `0d036504e049` — 2 info
  - added the new optional request property `boleto`
  - the `expiresInMinutes` request property's max was increased from `1440.00` to `10080.00`
- **2026-06-07** `bb5bf9a20957` — 1 info
  - added the new optional request property `enforcePayerDocument`
- **2026-05-10** `c1963c0f2a87` — 6 info
  - added the new optional request property `passFeeToPayer`
  - added the optional property `payment/oneOf[#/components/schemas/HeadlessPaymentCreateResponse]/feePassedToPayer` to the response with the `201` status
  - added the optional property `payment/oneOf[#/components/schemas/HeadlessPaymentCreateResponse]/isSandbox` to the response with the `201` status
  - added the optional property `payment/oneOf[#/components/schemas/HeadlessPaymentCreateResponse]/payerFeeAmount` to the response with the `201` status
  - added the optional property `payment/oneOf[#/components/schemas/HostedPaymentCreateResponse]/feePassedToPayer` to the response with the `201` status
  - added the optional property `payment/oneOf[#/components/schemas/HostedPaymentCreateResponse]/payerFeeAmount` to the response with the `201` status
- **2026-04-14** `74ad5da44cf9` — 4 breaking, 14 warning, 3 info
  - removed the enum value `CRYPTO_LTC` of the request property `methods/items/`
  - removed the enum value `LTC` of the request property `currency`
  - added `#/components/schemas/HeadlessPaymentCreateResponse, #/components/schemas/HostedPaymentCreateResponse` to the `payment` response property `oneOf` list for the response status `201`
  - the `payment` response's property type/format changed from `object`/`` to ``/`` for status `201`
  - removed the request property `split`
  - removed the optional property `payment/amount` from the response with the `201` status
  - removed the optional property `payment/createdAt` from the response with the `201` status
  - removed the optional property `payment/currency` from the response with the `201` status
  - removed the optional property `payment/description` from the response with the `201` status
  - removed the optional property `payment/expiresAt` from the response with the `201` status
  - removed the optional property `payment/feeAmount` from the response with the `201` status
  - removed the optional property `payment/id` from the response with the `201` status
  - removed the optional property `payment/metadata` from the response with the `201` status
  - removed the optional property `payment/methodData` from the response with the `201` status
  - removed the optional property `payment/netAmount` from the response with the `201` status
  - removed the optional property `payment/paymentMethod` from the response with the `201` status
  - removed the optional property `payment/status` from the response with the `201` status
  - removed the optional property `payment/txId` from the response with the `201` status
  - added the new optional request property `card`
  - added the new optional request property `customer/phone`
  - the response property `payment` became required for the status `201`
- **2026-04-14** `c75657100757` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/yuvexpay/apis/yuvexpay-api/docs/v1/payments/post.md) · [API](https://skmtc.dev/yuvexpay/apis/yuvexpay-api.md) · [Page](https://skmtc.dev/yuvexpay/apis/yuvexpay-api/changes/v1/payments/post)