---
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 1 of 2 revisions.

- **2026-11-03** `c13725f5409c`: 27 breaking, 29 warning, 129 info

## Changes

- **2026-11-03** `c13725f5409c`: 27 breaking, 29 warning, 129 info
  - added the new required request property `paymentInstrument/oneOf[#/components/schemas/Tokenized -> subschema #21: Tokenized]/token`
  - added the new required request property `paymentInstrument/oneOf[#/components/schemas/Tokenized -> subschema #21: Tokenized]/type`
  - added `#/components/schemas/BankDetails` to the `paymentInstrument/oneOf[subschema #25: TrueLayer]/bankDetails` request property `allOf` list
  - removed `#/components/schemas/BankAccountDetailsIBAN, #/components/schemas/BankAccountDetailsGB` from the `paymentInstrument/oneOf[subschema #25: TrueLayer]/bankDetails` request property `oneOf` list
  - the `paymentInstrument/oneOf[#/components/schemas/Tokenized -> subschema #21: Tokenized]/` request property type changed from no type to `object`
  - the `paymentInstrument/oneOf[subschema #25: TrueLayer]/bankDetails` request property type changed from `object` to no type
  - the response's body type changed from `object` to no type for status `400`
  - the response's body type changed from `object` to no type for status `500`
  - the response's body type changed from `object` to no type for status `502`
  - the `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseApplePay]/allOf[#/components/schemas/ApplePayDetails]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/fingerprint` response property's maxLength was unset from `64` for the response status `201`
  - the `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseApplePay]/allOf[#/components/schemas/ApplePayDetails]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/fingerprint` response property's maxLength was unset from `64` for the response status `202`
  - the `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseApplePay]/allOf[#/components/schemas/ApplePayDetails]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/fingerprint` response property's maxLength was unset from `64` for the response status `422`
  - the `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseCard]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/fingerprint` response property's maxLength was unset from `64` for the response status `201`
  - the `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseCard]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/fingerprint` response property's maxLength was unset from `64` for the response status `202`
  - the `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseCard]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/fingerprint` response property's maxLength was unset from `64` for the response status `422`
  - the `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseGooglePay]/allOf[#/components/schemas/GooglePayDetails]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/fingerprint` response property's maxLength was unset from `64` for the response status `201`
  - the `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseGooglePay]/allOf[#/components/schemas/GooglePayDetails]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/fingerprint` response property's maxLength was unset from `64` for the response status `202`
  - the `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseGooglePay]/allOf[#/components/schemas/GooglePayDetails]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/fingerprint` response property's maxLength was unset from `64` for the response status `422`
  - the `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseTokenized]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/fingerprint` response property's maxLength was unset from `64` for the response status `201`
  - the `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseTokenized]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/fingerprint` response property's maxLength was unset from `64` for the response status `202`
  - the `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseTokenized]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/fingerprint` response property's maxLength was unset from `64` for the response status `422`
  - the `allOf[subschema #4: PaymentResponse]/action` response's property type changed from no type to `object` for status `201`
  - the `allOf[subschema #4: PaymentResponse]/action` response's property type changed from no type to `object` for status `202`
  - the `allOf[subschema #4: PaymentResponse]/action` response's property type changed from no type to `object` for status `422`
  - the `allOf[subschema #4: PaymentResponse]/psp/additionalInfo/oneOf[#/components/schemas/PaysafecardAdditionalInfo]/customerIpAddress` response's property format changed from `ipv4` to no format for status `201`
  - the `allOf[subschema #4: PaymentResponse]/psp/additionalInfo/oneOf[#/components/schemas/PaysafecardAdditionalInfo]/customerIpAddress` response's property format changed from `ipv4` to no format for status `202`
  - the `allOf[subschema #4: PaymentResponse]/psp/additionalInfo/oneOf[#/components/schemas/PaysafecardAdditionalInfo]/customerIpAddress` response's property format changed from `ipv4` to no format for status `422`
  - removed `#/components/schemas/PaymentInstrumentRequestBase, subschema #2` from the `paymentInstrument/oneOf[#/components/schemas/Tokenized -> subschema #21: Tokenized]/` request property `allOf` list
  - changed the pattern of the request property `customerIpAddress` from `^$|^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$` to `^$|^((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)(\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)){3}|(([0-9a-fA-F]{1,4}:){7}[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,7}:|([0-9a-fA-F]{1,4}:){1,6}:[0-9a-fA-F]{1,4}|([0-9a-fA-F]{1,4}:){1,5}(:[0-9a-fA-F]{1,4}){1,2}|([0-9a-fA-F]{1,4}:){1,4}(:[0-9a-fA-F]{1,4}){1,3}|([0-9a-fA-F]{1,4}:){1,3}(:[0-9a-fA-F]{1,4}){1,4}|([0-9a-fA-F]{1,4}:){1,2}(:[0-9a-fA-F]{1,4}){1,5}|[0-9a-fA-F]{1,4}:((:[0-9a-fA-F]{1,4}){1,6})|:((:[0-9a-fA-F]{1,4}){1,7}|:)|::(ffff(:0{1,4})?:)?((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)|([0-9a-fA-F]{1,4}:){1,4}:((25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)\.){3}(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)))$`
  - removed the optional property `additionalErrorDetails` from the response with the `400` status
  - removed the optional property `additionalErrorDetails` from the response with the `500` status
  - removed the optional property `additionalErrorDetails` from the response with the `502` status
  - removed the optional property `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseApplePay]/allOf[#/components/schemas/ApplePayDetails]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/metadata/metadataType` from the response with the `201` status
  - removed the optional property `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseApplePay]/allOf[#/components/schemas/ApplePayDetails]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/metadata/metadataType` from the response with the `202` status
  - removed the optional property `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseApplePay]/allOf[#/components/schemas/ApplePayDetails]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/metadata/metadataType` from the response with the `422` status
  - removed the optional property `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseCard]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/metadata/metadataType` from the response with the `201` status
  - removed the optional property `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseCard]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/metadata/metadataType` from the response with the `202` status
  - removed the optional property `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseCard]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/metadata/metadataType` from the response with the `422` status
  - removed the optional property `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseGooglePay]/allOf[#/components/schemas/GooglePayDetails]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/metadata/metadataType` from the response with the `201` status
  - removed the optional property `allOf[#/components/schemas/IncludedRelationships]/included/items/oneOf[#/components/schemas/IncludedRelationshipsItemPaymentInstrument]/allOf[subschema #1]/attributes/oneOf[#/components/schemas/PaymentResponseGooglePay]/allOf[#/components/schemas/GooglePayDetails]/allOf[#/components/schemas/DetailsOfAssociatedCardPaymentInstrument]/metadata/metadataType` from the response with the `202` status
  - …145 more

---

[Operation](https://skmtc.dev/br-dge/apis/br-dge-transaction-rest-api/docs/payments/post.md) - [API](https://skmtc.dev/br-dge/apis/br-dge-transaction-rest-api.md) - [Page](https://skmtc.dev/br-dge/apis/br-dge-transaction-rest-api/changes/payments/post)