open menu
axerve docs
Payments/Payment management/Modifying payments/Reverse a settled payment

Reverse a settled payment 

SOAP

This operation reverses (totally or partially) a settlement operation. From an account perspective it consists in debiting the merchant and subsequently crediting back the amount originally due to the buyer’s credit card.

Obviously, it may be performed only on already-settled transactions.

An already-settled transaction may also be reversed more than once, for partial amounts, until a total equal to the settled amount is reached.

The correct WSs2s web service method to be used for this purpose is CallRefundS2S.

However, before using this method, it is necessary to assign to WSs2s all of the information required to securely identify the transaction to be reversed.

A transaction may be uniquely identified by the pair shopLogin + bankTransactionID.

It is however possible to use also the code assigned by the merchant to the transaction, taking care first to ascertain that the code uniquely identifies a transaction; otherwise, CallRefundS2S will return an error code referring to a Non-uniquely identified transaction.

As a transaction may be reversed also for an amount which is less than the amount for which the transaction was settled, it is necessary also to assign to CallRefundS2S the amount to be withdrawn and the currency code in which the amount is expressed.

default

The currency must be the same as the settled amount.

In order to do all this it is sufficient to set the specific fields:

  • shopLogin (merchant code)

  • bankTransactionID (Axerve Ecommerce Solutions transaction code) or

  • shopTransactionID (merchant transaction ID code)

  • uicCode (currency codeapi link)

  • amount (amount)

Unlike the authorisation request operation, the reversal operation cannot incur a negative result, unless this is due to technical reasons. In order to know the outcome of the operation, it is therefore sufficient to consult its technical result, by reading in the XML return file the following values:

  • ErrorCode (and ErrorDescription)

default

Please notice that the cancellation of an operation is not simultaneous. The positive response to the call S2S of refund means that the request has been correctly undertaken. The event of “REQ” (request of cancellation) is added to the transaction to identify the undertaking of the refund. The event “STO” is added if the cancellation is accepted and processed.

Previous
prevCancel an authorized payment
Next
Query transaction statusnext

Create your test account to try the service!

Register
© 2007-2024 Axerve S.p.A. Company with Single Shareholder belonging to the Maurizio Sella S.a.a. VAT Group with VAT no. 02675650028 – Tax Code 02686620028 – Biella Court registration no. 71524 – Piazza Gaudenzio Sella 1, 13900 Biella – Share Capital € 4,000,000.00 fully paid-in – Registered in the Reg. Impr. C.C.I.A.A. Monte Rosa Laghi Alto Piemonte – Registered in the Register of Payment Institutions.