settle - 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-Password, generated by merchant in DIBS Manager.
verifyID *	DIBS reference number, this must be the same verifyID as from the authorization response.
amount *	The amount to be settled
extra	Please refer to the description of the 'extra' parameter on the Web Service page. The MAC parameter should be included in the extra string. The following formula should be used for this call: X('VerifyId&amount&SecretKey&')

Example

Below is an example of the settlement request using SOAP.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v2="https://securedt.dibspayment.com/DTServerModuleService/v2">
   <soapenv:Header/>
   <soapenv:Body>
      <v2:settle>
         <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>358433619</v2:verifyID>
         <v2:amount>200</v2:amount>
         <!--Optional:-->
         <v2:extra></v2:extra>
      </v2:settle>
   </soapenv:Body>
</soapenv:Envelope>

The following is an example of a response:

<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
   <soapenv:Body>
      <ns:settleResponse 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>101</ns:resultCode>
            <ns:resultText>settlement_OK</ns:resultText>
            <ns:verifyID>358433619</ns:verifyID>
         </ns:return>
      </ns:settleResponse>
   </soapenv:Body>
</soapenv:Envelope>