---
title: "Changes to Initiate a payment"
method: POST
path: "/rest/payments/{payment-id}/init"
---

# Changes to Initiate a payment

`POST /rest/payments/{payment-id}/init`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `398592d93b1f`: 6 breaking, 1 warning, 5 info

## Changes

- **2026-11-03** `398592d93b1f`: 6 breaking, 1 warning, 5 info
  - the `state` request property's minLength was increased from `0` to `1`
  - the `redirect_uri` request property type changed from no type to `string`, and format from no format to `url`
  - the `state` request property type changed from no type to `string`
  - added `subschema #1, subschema #2, subschema #3, subschema #4, subschema #5` to the `challenge` response property `oneOf` list for the response status `201`
  - the `error` response's property type changed from no type to `object` for status `201`
  - the `id` response's property type changed from no type to `string`, and format from no format to `UUID` for status `201`
  - the `state` request property's maxLength was set to `1024`
  - added the optional property `error/code` to the response with the `201` status
  - added the optional property `error/description` to the response with the `201` status
  - added the optional property `error/group` to the response with the `201` status
  - added the optional property `error/message` to the response with the `201` status
  - added the optional property `error/name` to the response with the `201` status

---

[Operation](https://skmtc.dev/qwist/apis/finx-api/docs/rest/payments/:payment-id/init/post.md) - [API](https://skmtc.dev/qwist/apis/finx-api.md) - [Page](https://skmtc.dev/qwist/apis/finx-api/changes/rest/payments/:payment-id/init/post)