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. The following MAC formula should be used for this request:

X('VerifyId&SecretKey&')

 

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 a 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