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

# Changes to Create a payment

`POST /payments`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 14 revisions.

- **2026-11-05** `b216574b9612`: 1 breaking, 1 warning
- **2026-11-03** `5d26657495a3`: 1 breaking, 2 info
- **2026-10-16** `fce1879654d8`: 4 breaking, 6 warning, 3 info
- **2026-05-20** `24e860ade740`: 2 info
- **2026-01-16** `7bf10db291f4`: 144 warning, 19 info
- **2025-04-25** `86ccaf2d7c61`: 1 info

## Changes

- **2026-11-05** `b216574b9612`: 1 breaking, 1 warning
  - the response property `payment/payment_status` became nullable for the status `200`
  - added the new `undefined` enum value to the `payment/payment_status` response property for the response status `200`
- **2026-11-03** `5d26657495a3`: 1 breaking, 2 info
  - the `payment/invoice_id` request property format changed from no format to `uuid`
  - added the non-success response with the status `403`
  - added the non-success response with the status `404`
- **2026-10-16** `fce1879654d8`: 4 breaking, 6 warning, 3 info
  - the response property `payment/payment_provider_code` became nullable for the status `200`
  - the response property `payment/payment_provider_type` became nullable for the status `200`
  - the response property `payment/provider_customer_id` became nullable for the status `200`
  - the response property `payment/reference` became nullable for the status `200`
  - the `payment/reference` request property's maxLength was set to `40`
  - the `payment/amount_cents` request property's min was set to `1.00`
  - removed the optional property `payment/payment_method_id` from the response with the `200` status
  - added the new `SYP` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `TND` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `undefined` enum value to the `payment/payment_provider_type` response property for the response status `200`
  - added the optional property `payment/payment_method` to the response with the `200` status
  - the response property `payment/invoice_numbers` became required for the status `200`
  - response property `payment/external_payment_id` deprecated
- **2026-05-20** `24e860ade740`: 2 info
  - added the optional property `payment/invoice_numbers` to the response with the `200` status
  - added the optional property `payment/payment_method_id` to the response with the `200` status
- **2026-01-16** `7bf10db291f4`: 144 warning, 19 info
  - added the new `AED` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `AFN` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `ALL` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `AMD` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `ANG` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `AOA` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `ARS` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `AUD` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `AWG` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `AZN` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `BAM` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `BBD` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `BDT` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `BGN` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `BIF` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `BMD` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `BND` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `BOB` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `BRL` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `BSD` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `BWP` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `BYN` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `BZD` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `CAD` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `CDF` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `CHF` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `CLF` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `CLP` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `CNY` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `COP` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `CRC` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `CVE` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `CZK` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `DJF` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `DKK` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `DOP` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `DZD` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `EGP` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `ETB` enum value to the `payment/amount_currency` response property for the response status `200`
  - added the new `EUR` enum value to the `payment/amount_currency` response property for the response status `200`
  - …123 more
- **2025-04-25** `86ccaf2d7c61`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/getlago/apis/lago-api-documentation/docs/payments/post.md) - [API](https://skmtc.dev/getlago/apis/lago-api-documentation.md) - [Page](https://skmtc.dev/getlago/apis/lago-api-documentation/changes/payments/post)
