authorizeAndSettle3DS

Performs an authorization and settlement through a 3d-secure active acquirer agreement.

The 3d-secure flow is described in our 3d-secure guide.

Permission to send card data must be activated by DIBS. Usage of authorizeAndSettle3DS API requires a PCI certification.
If you are creating payments through the API you need to ensure that you have the right PCI-certificate to do so.

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.
paRes * PaRes message obtained from a call to the askIf3DSEnrolled API.
extra Please refer to the description of the 'extra' parameter on the Web Service page.

Example

Below is an example of the authorizeAndSettle3DS 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:authorizeAndSettle3DS>
         <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:paRes>eJxVUsFuwjAM/ZWK66Q6adOWIROJDaTBNMQYl+1WWo92jBSawNi+fkmhg/XkZ8fPz8/FRVE...</v2:paRes>
         <!--Optional:-->
         <v2:extra></v2:extra>
      </v2:authorizeAndSettle3DS>
   </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:authorizeAndSettle3DSResponse 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>250</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>100</ns:resultCode>
            <ns:resultText>verification_OK</ns:resultText>
            <ns:verifyID>358433619</ns:verifyID>
         </ns:return>
      </ns:authorizeAndSettle3DSResponse>
   </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