Reversal

Transactions, which are not cleared yet (reside in state RESERVED) can be canceled with the ManualReverse call. The reversal of a transaction is final, the transaction can not be cleared afterwards.

🚧
Not all payment systems support this operation, please see chapter Payment systems for more details about specific payment systems.

Operation: ManualReverse

📘
The merchant can reverse the transactions manually over the merchant portal. The transaction status changed can be received via the push method (see Payment notification). More information about reversing via the merchant portal can be found in the Merchant Interface Manual.

A transaction can be reversed by providing the mpayTID element. Only one transaction per request can be canceled.

<SOAP-ENV:Envelope 
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
  xmlns:etp="https://www.mpay24.com/soap/etp/1.5/ETP.wsdl">
  <SOAP-ENV:Header/>
  <SOAP-ENV:Body>
    <etp:ManualReverse>
      <merchantID>90000</merchantID>
      <mpayTID>1678288</mpayTID>
    </etp:ManualReverse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

<SOAP-ENV:Envelope 
  xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" 
  xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" 
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
  xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
  xmlns:etp="https://www.mpay24.com/soap/etp/1.5/ETP.wsdl">
  <SOAP-ENV:Header/>
  <SOAP-ENV:Body>
    <etp:ManualReverseResponse>
      <status>OK</status>
      <returnCode>OK</returnCode>
      <transaction>
        <mpayTID>1678288</mpayTID>
        <tStatus>REVERSED</tStatus>
        <tid>145000013</tid>
      </transaction>
    </etp:ManualReverseResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

As response the cancelled transaction is listed with its current state.

📘
The status and returnCode should be checked to determine if the operation was successful.