Processing pre-authorisations

A pre-authorisation is used to seek authorisation for a transaction and reserve the funds on the customer’s account, in cases where the final amount to be debited from the customer is not known at time of authorisation. By default, the funds reserved by pre-authorisations are typically settled within 24 hours, but if required, they can be deferred for up to 31 days. If the transaction is not settled within this time-frame, we will automatically cancel the transaction and the funds will be released back into the customer’s bank account.

Settlement can be deferred by up to 31 days following authorisation.

Prior to settlement, the final settlement amount can be updated to a lower value.

Prior to settlement, the transaction can be cancelled.

Pre-authorisations are most useful when employed in the following scenarios:

The final amount to be debited from the customer is not yet known:
- You can update the final settle amount to be a lower value than the amount originally authorised.
- For those assigned with supported merchant category codes, Visa supports the processing of incremental authorisations in order to increase the final settle amount to a higher value than was originally authorised.
The settlement time is not yet known:
- The funds can be settled for up to 31 days after authorisation.
- For those assigned with supported merchant category codes, Mastercard supports the processing of split shipments, to settle parts of the authorised funds as and when goods/services have been delivered, over a period of 31 days.
Cancelling an order:
- You can cancel pre-authorisations without incurring penalties or additional charges from Mastercard or Visa.

Requirements

You can only process pre-authorisations with Mastercard and Visa-branded cards.

Mastercard Europe have mandated that Mastercard and Maestro transactions processed with certain European acquiring banks must be flagged as either pre-authorisation or final authorisation. Such transactions are subject to acquirer-specific conditions.

Failure to adhere to these conditions may incur a fine from Mastercard.
For full terms and conditions, please contact your acquiring bank.

Default behaviour

By default, authorisations are processed as final authorisations in cases where a distinction is required by the participating acquirer. You can change this default behaviour to submit pre-authorisations, by contacting our Support Team. Alternatively, you can override the default behaviour on a transaction-by-transaction basis by following the instructions below.

If you are not sure whether your site has been configured to process pre-authorisations or final authorisations, click here to learn how to check using Portal.

Payment Pages

Request example

If you need to override the site reference’s default auth method to process a pre-authorisation, include the authmethod in your POST to Payment Pages as shown in the example below.
You can optionally include settlestatus set to 2, which will suspend the payment on the Trust Payments system until you are ready to settle the transaction manually. When ready, you can use Portal to update the transaction to settlestatus 1, which will ensure funds are settled into your bank account in the next settlement batch, which typically completes within 24 hours.

<input type="hidden" name="authmethod" value="PRE">
<input type="hidden" name="settlestatus" value="2">

Pre-authorisations can be suspended for up to 31 days, after which they will be automatically cancelled by Trust Payments.

Alternatively, the settleduedate can also optionally be included to specify a specific preferred settlement date (format: YYYY-MM-DD) for the transaction. Provided no updates are performed between authorisation and the assigned settle due date, settlement is processed automatically. (You can update and/or cancel pending transactions using Portal)

<input type="hidden" name="authmethod" value="PRE">
<input type="hidden" name="settleduedate" value="2022-01-28">

Site security considerations:

If including the authmethod, settlestatus or settleduedate in your POST, the value of these fields need to be included in the correct position within the string used to generate your request site security hash. Failure to do so will result in the customer being shown an “Invalid details” error message. Click here for further information on site security, and the default order of fields in the string.

API

Request example

If you need to override the site reference’s default auth method, you will need to ensure the payload submitted within your JWT contains authmethod with value "PRE", as shown in the example below.
- The authmethod field can only be submitted in THREEDQUERY and AUTH requests.
- If a value for the authmethod field is submitted to the acquirer during authorisation, it will always be returned within the response.
You can optionally include settlestatus set to 2, which will suspend the payment on the Trust Payments system until you are ready to settle the transaction manually. When ready, your system can submit a TRANSACTIONUPDATE request using Webservices API to update the transaction to settlestatus 1, which will ensure funds are settled into your bank account in the next settlement batch, which typically completes within 24 hours.

{
  "payload":{
    "accounttypedescription":"ECOM",
    "baseamount":"1050",
    "currencyiso3a":"GBP",
    "sitereference":"test_site12345",
    "requesttypedescriptions":["THREEDQUERY","AUTH"],
    "authmethod":"PRE",
    "settlestatus":"2"
  },
  "iat":1559033849,
  "iss":"jwt.user"
}

{
  "payload":{
    "accounttypedescription":"ECOM",
    "baseamount":"1050",
    "currencyiso3a":"GBP",
    "sitereference":"test_site12345",
    "termurl":"https://payments.securetrading.net/process/payments/mobilesdklistener",
    "requesttypedescriptions":["THREEDQUERY","AUTH"],
    "authmethod":"PRE",
    "settlestatus":"2"
  },
  "iat":1559033849,
  "iss":"jwt.user"
}

Pre-authorisations can be suspended for up to 31 days, after which they will be automatically cancelled by Trust Payments.

Alternatively, the settleduedate can also optionally be included to specify a specific preferred settlement date (format: YYYY-MM-DD) for the transaction. Provided no updates are performed between authorisation and the assigned settle due date, settlement is processed automatically. (You can update and/or cancel pending transactions by submitting a TRANSACTIONUPDATE request using Webservices API)

{
  "payload":{
    "accounttypedescription":"ECOM",
    "baseamount":"1050",
    "currencyiso3a":"GBP",
    "sitereference":"test_site12345",
    "requesttypedescriptions":["THREEDQUERY","AUTH"],
    "authmethod":"PRE",
    "settleduedate":"2022-01-28"
  },
  "iat":1559033849,
  "iss":"jwt.user"
}

{
  "payload":{
    "accounttypedescription":"ECOM",
    "baseamount":"1050",
    "currencyiso3a":"GBP",
    "sitereference":"test_site12345",
    "termurl":"https://payments.securetrading.net/process/payments/mobilesdklistener",
    "requesttypedescriptions":["THREEDQUERY","AUTH"],
    "authmethod":"PRE",
    "settleduedate":"2022-01-28"
  },
  "iat":1559033849,
  "iss":"jwt.user"
}

Updating deferred transactions

You can update deferred pre-authorisations prior to settlement. Supported updates include:

Updating the final settle amount to be a lower value than originally authorised by the issuing bank.
Updating the settle due date, providing the date is within 31 days from the time the transaction was authorised.

Updating the settle due date to today's date will instruct Trust Payments to settle the transaction in the next batch sent to your acquiring bank (this typically occurs within 24 hours).
Cancelling the transaction by updating the settle status to 3.

To process an update, you can either use Portal or submit a TRANSACTIONUPDATE request using our Webservices API.

Processing pre-authorisations

Further reading on this topic