---
title: "Changes to Process a preauthorize: reserves the payment amount on the customer's payment instrument"
method: POST
path: "/transaction/{apiKey}/preauthorize"
---

# Changes to Process a preauthorize: reserves the payment amount on the customer's payment instrument

`POST /transaction/{apiKey}/preauthorize`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 3 of 4 revisions.

- **2026-11-07** `42c40d316a83`: 1 warning, 11 info
- **2025-04-27** `5d765c6bfe90`: 4 info
- **2024-07-22** `65196339abf0`: 4 breaking, 7 info

## Changes

- **2026-11-07** `42c40d316a83`: 1 warning, 11 info
  - changed the pattern of the request property `threeDSecureData/browserTimezone/anyOf[subschema #2]/` from `^[\-]?\d+$` to `^[\-\+]?\d{1,4}$`
  - added the new optional request property `customerProfileData/paymentToken`
  - added the new optional request property `requestPartialAuthorization`
  - added the new `Eftpos` enum value to the request property `threeDSecureData/schemeId`
  - added the optional property `adapterMerchantTransactionId` to the response with the `200` status
  - added the optional property `amount` to the response with the `200` status
  - added the optional property `customerProfileData/paymentToken` to the response with the `200` status
  - added the optional property `gstAmount` to the response with the `200` status
  - added the optional property `returnData/oneOf[#/components/schemas/ReturnCardData]/referenceSchemeLifecycleIdentifier` to the response with the `200` status
  - added the optional property `returnData/oneOf[#/components/schemas/ReturnCardData]/schemeLifecycleIdentifier` to the response with the `200` status
  - added the optional property `surchargeAmount` to the response with the `200` status
  - added the optional property `totalAmount` to the response with the `200` status
- **2025-04-27** `5d765c6bfe90`: 4 info
  - added the new optional request property `includeTracing`
  - added the optional property `returnData/oneOf[#/components/schemas/ReturnCardData]/binRawData` to the response with the `200` status
  - added the optional property `returnData/oneOf[#/components/schemas/ReturnCardData]/binSegment` to the response with the `200` status
  - added the optional property `returnData/oneOf[#/components/schemas/ReturnCardData]/cardUpdatePausedUntil` to the response with the `200` status
- **2024-07-22** `65196339abf0`: 4 breaking, 7 info
  - added the pattern `^(([0-9]{1,10})|([0-9]{1,10}\.[0-9]{1,3}))$` to the request property `splits/items/amount`
  - added the pattern `^(([0-9]{1,10})|([0-9]{1,10}\.[0-9]{1,3}))$` to the request property `splits/items/commissionFee/amount`
  - the `splits/items/amount` request property type changed from `number` to `string`
  - the `splits/items/commissionFee/amount` request property type changed from `number` to `string`
  - added the new optional request property `captureInMinutes`
  - added the new optional request property `l2l3Data/dutyAmount`
  - added the new optional request property `l2l3Data/freightTaxAmount`
  - added the optional property `returnData/oneOf[#/components/schemas/ReturnCardData]/cardUpdateStatus` to the response with the `200` status
  - added the optional property `returnData/oneOf[#/components/schemas/ReturnCardData]/cardUpdatedAt` to the response with the `200` status
  - added the optional property `returnData/oneOf[#/components/schemas/ReturnCardData]/parsedMerchantAdviceCode` to the response with the `200` status
  - added the optional property `returnData/oneOf[#/components/schemas/ReturnCardData]/schemeTransactionIdentifier` to the response with the `200` status

---

[Operation](https://skmtc.dev/tillpayments/apis/till-payments-gateway/docs/transaction/:apiKey/preauthorize/post.md) - [API](https://skmtc.dev/tillpayments/apis/till-payments-gateway.md) - [Page](https://skmtc.dev/tillpayments/apis/till-payments-gateway/changes/transaction/:apiKey/preauthorize/post)