authReversal - DIBS Technical Documentation

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. This call requires the following MAC formula to be used: X('VerifyId&amount&SecretKey&') MAC checksum is used to make sure no third party has modified 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>