Incremental Authorisation
The incremental authorisation feature allows you to increment the value of your original pre-authorisation for scenarios where you need to charge your customer a higher total amount.
By incrementing the pre-authorisation value, you will be able to capture the total amount that you wish to charge your customer when you are ready.
You can be assured the total amount that will be charged to the consumer can be captured at a later stage. This is because the amount is ring-fenced in the consumer’s account.
We will describe how an original pre-authorisation can be updated to include additional amounts.
There may be additional considerations to take into account to ensure that incremental authorisation can work with Apple Pay™. We will update you with any requirements, once we know more. For Google Pay™, currently there are no additional considerations for incremental authorisation flows, however this may change over the course of 2025 and we will update you accordingly.
- This feature is not available with all acquirers. Check with our customer service team, or your account manager for your eligibility to use this.
- You can only increment a preAuth that has been set up correctly.
An incremental authorisation can only be used in the context of an existing pre- authorisation. The end to end flow contains the following steps:
- The initial step is to process a preAuth request.
- When submitting the preAuth request, to increment a preAuth set the allowIncrement flag to true in the request body.
- This ensures the acquirer is expecting the amount of the initial preAuth to be amended in the future.
- You can set the allowIncrement flag in the following ways:
- Using our SDKs when invoking a preAuth:
- See our SDK integration sections for more details:
- As part of the POST /transactions/preauths request body
- As part of the POST /webpayments/preauths request body
Here, the amount of the initial preAuth request can be incremented.
- Make a call to the Judopay Transaction API using the endpoint: POST /transactions/incrementalAuth
- This request must contain the:
- New total authorisation amount. The Authorisation amount is the sum of the original preAuth amount + the amount(s) you wish to increment.
- The incrementalAuth step can be repeated multiple times if required.
- Each new increment must reference the receiptId of the original initial preAuth.
- Each new increment must take into account the total amount authorised so far. The initial preAuth amount + sum of all increments.
For the purpose of this exercise, the following example is using the request body for the POST /transactions/incrementalAuthendpoint:
- To capture the full amount to collect from your customer:
- Make a call to the Judopay Transaction API using the endpoint: POST /transactions/collections
- The amount specified in the request should include the total amount you wish to collect. This can be less than, or equal to the total amount authorised.