No results

Authorisation cancellation

By voiding an authorisation you can help ensure that the amount of a previously approved transaction is released back onto the cardholder's credit card.

Void Authorisation operation is supported by the following payment methods:

  • Credit cards, debit cards and prepaid

Void Authorisation operation is IRREVERSIBLE.

NOTE: the effectiveness of the authorization cancellation operation depends on both the type of card used both by the issuing bank's policies; it is recommended to cancel the authorization in the days immediately following the issue of the authorization, in alternative the operation could be refused.

Transmission of authorisation cancellation message

Example of HTTP authorisation cancellation message
id=99999999&password=99999999&tenantId=10&operationType=voidauthorization&paymentId=123456789012 345

Call parameters of HTTP authorisation cancellation message

NAME DESCRIPTION FORMAT
id Id associated with terminal N
Max. length: 8
password Terminal id password AN
Max. length: 50
tenantId Identification code of the acquiring service to which the merchant belongs. In the case of a merchant having an agreement with Intesa enter "10", otherwise enter "20". N
operationType 'voidauthorization' AN
paymentid Unique identifier of the Gateway authorization request AN
Max. length: 18
customField Custom field AN
Max. length: 255
description Payment description AN
Max. length: 255
Example of XML authorisation cancellation outcome message

Parameters of response to authorisation cancellation message

NAME DESCRIPTION FORMAT
paymentid Unique identifier of the Gateway authorization request AN
Max. length: 18
result Reversal outcome:
  • AUTH VOIDED = voided authorisation
 AN
Max. length: 20
responsecode Response code (e.g. '000' if the transaction is authorised, in all other cases the transaction is rejected) N
Max. length: 3
authorizationcode Authorisation code, which is entered only if the transaction has been authorised AN
Max. length: 6
merchantorderid Reference Transaction sent by the merchant in the Accounting reversal phase (can only contain letters and numbers and must be unique in absolute). AN
Max. length: 18
description Payment description AN
Max. length: 255
customfield Custom field sent to the merchant in Initialisation phase AN
Max. length: 255

Behaviour of the system in case of error during authorisation cancellation

If incorrect parameters are sent (e.g. unknown terminal, incorrect password, attempt to void an already voided payment, attempt to void a payment an unauthorised payment,...) the Gateway responds with an error message in XML format.

This message includes:

  • an error code
  • a mnemonic description of the error

Example of error message during authorisation cancellation