Incremental authorization allows you to increase the amount of a previously authorized transaction. You can only increment the original authorized amount by 30% or by €300 whichever is lower. You can only send one incremental authorization request for the original transaction.
Payment flow
Incremental authorization works in a 3-step sequence:
1. Initial authorization
The initial authorization is submitted as usual by calling Create paymentCreate payment.
2. Incremental authorization
To add funds to the original authorization, submit an Incremental authorization request via the Incremental authorizationIncremental authorization endpoint.
- This request includes only the incremental amount (i.e., the additional amount you wish to authorize on top of the original).
- You must reference the original authorization's
payIdto link the requests.
The
incrementalAmountis not the new total. It is the amount to add on top of the already authorized value.
3. Final capture
When the final amount is known, submit a Capture paymentCapture payment request that reflects the total amount (original authorization + incremental authorization).
📌 Make sure that the total capture amount does not exceed the combined total of the original and incremental authorization.