authReversal

Cancels a previously made authorization. This will also release any money reserved on the customers account.

Input parameters

Essential parameter name Description
shopName* Merchant shopname, provided by DIBS.
userName * API-Username, generated by merchant in DIBS Manager.
password * API-User password, generated by merchant in DIBS Manager.
verifyID * verifyID for the transaction to be auth reversed
amount * The amount to be auth reversed
extra Please refer to the description of the 'extra' parameter on the Web Service page.
MAC (extra)

This parameter should be sent in the extra-field.

MAC checksum used to make sure no one has tampered with the information. See the MAC page for more information.

 

*: Always validated by DIBS

Example

Below is an example of a authReversal request using SOAP.

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:v2="https://securedt.dibspayment.com/DTServerModuleService/v2">
   <soap:Header/>
   <soap:Body>
      <v2:authReversal>
         <v2:shopName>Insert your shopname here</v2:shopName>
         <v2:userName>Insert your API username here</v2:userName>
         <v2:password>Insert your API password here</v2:password>
         <v2:verifyID>358444833</v2:verifyID>
         <v2:amount>200</v2:amount>
         <!--Optional:-->
         <v2:extra>&amp;MAC=D6174BCEE45E0287C5C15899E7B2668AC1269845</v2:extra>
      </v2:authReversal>
   </soap:Body>
</soap:Envelope>

The following is an example of the response:

<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
   <soapenv:Body>
      <ns:authReversalResponse xmlns:ns="https://securedt.dibspayment.com/DTServerModuleService/v2">
         <ns:return>
            <ns:aCSUrl xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:acquirerAddress xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:acquirerAuthCode/>
            <ns:acquirerAuthResponseCode/>
            <ns:acquirerCity xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:acquirerConsumerLimit xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:acquirerErrorDescription xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:acquirerFirstName xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:acquirerLastName xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:acquirerMerchantLimit xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:acquirerZipCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:amount>200</ns:amount>
            <ns:errorMsg/>
            <ns:infoCode xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:infoDescription xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:pAReqMsg xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
            <ns:resultCode>106</ns:resultCode>
            <ns:resultText>authreversal_OK</ns:resultText>
            <ns:verifyID>358444833</ns:verifyID>
         </ns:return>
      </ns:authReversalResponse>
   </soapenv:Body>
</soapenv:Envelope>
Do you have question or need help?
Follow us
DIBS Payment Services
Stockholm +46 (0)8-527 525 00
Göteborg +46 031-600 800
København +45 7020 3077
Oslo +47 21 55 44 00