askIf3DSEnrolled - DIBS Technical Documentation

Permission to send card data must be activated by DIBS. Usage of askIf3DSEnrolled 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-User password, generated by merchant in DIBS Manager.
billingFirstName *	First name
billingLastName *	Last name
billingAddress *	Address
billingCity *	City
billingCountry *	Country
cc *	Credit card number
expM *	Expiry month
expY *	Expiry year
eMail *	Consumer's email address.
ip *	The IP number of the customer. If the IP address is not available, please send the empty string.
data *	All information applying to the consumer’s order is included in the data parameter. Please refer to our order information page regarding the format of this parameter.
currency *	You have the option of controlling the currency you wish to use via the currency parameter. The value of the currency must be in what is known as the ISO-4217 ISO/SWIFT currency format (e.g. SEK, GBP, USD, NOK, DKK, FIM), and in uppercase letters. Refer to http://www.xe.com/iso4217.php for a complete list.
httpAcceptHeader *	HTTP Accept header from the customers browser
httpUserAgentHeader *	HTTP User Agent header from the customers browser
referenceNo	This parameter is used when the customer wish to place a merchant reference number on an order in DIBS system which allows it to be searchable via DIBS Manager. This parameter must be unique for each new payment.
method	DIBS supports several different payment methods. The parameter method is used to define the payment method to be selected for the current order. Please refer to the methods page for possible values. Default value: 'cc.amex'.
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. The following MAC formula should be used for this request: X('data&currency&[referenceData&]SecretKey&') MAC checksum is 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 the authorizeAndSettle 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:askIf3DSEnrolled>
         <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:billingFirstName>Olle</v2:billingFirstName>
         <v2:billingLastName>Svensson</v2:billingLastName>
         <v2:billingAddress>Examplestreet 1</v2:billingAddress>
         <v2:billingCity>Stockholm</v2:billingCity>
         <v2:billingCountry>SE</v2:billingCountry>
         <v2:cc>4711100000000000</v2:cc>
         <v2:expM>06</v2:expM>
         <v2:expY>24</v2:expY>
         <v2:eMail>example@email.com</v2:eMail>
         <v2:ip>10.0.0.0</v2:ip>
         <v2:data>12a:pen:2:100:10b:pencil:1:50:</v2:data>
         <v2:currency>SEK</v2:currency>
         <v2:httpAcceptHeader>text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8</v2:httpAcceptHeader>
         <v2:httpUserAgentHeader>Mozilla /5.0 (Compatible MSIE 9.0;Windows NT 6.1;WOW64; Trident/5.0)</v2:httpUserAgentHeader>
         <v2:method>cc.cekab</v2:method>
         <!--Optional:-->
         <v2:referenceNo>123A456B789C</v2:referenceNo>
         <!--Optional:-->
         <v2:extra>&amp;MAC=D6174BCEE45E0287C5C15899E7B2668AC1269845&securityCode=684</v2:extra>
      </v2:askIf3DSEnrolled>
   </soapenv:Body>
</soapenv:Envelope>

The following is an example of the response:

<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
   <soapenv:Body>
      <ns:askIf3DSEnrolledResponse xmlns:ns="https://securedt.dibspayment.com/DTServerModuleService/v2">
         <ns:return>
            <ns:aCSUrl>https://acs3.3dsecure.no/mdpayacs/pareq</ns:aCSUrl>
            <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>eJxVUsFuwjAM/ZWK66Q6adOWIROJDaTBNMQYl+1WWo92jBSawNi+fkmhg/XkZ8fPz8/FRVE...</ns:pAReqMsg>
            <ns:resultCode>107</ns:resultCode>
            <ns:resultText>enrolled</ns:resultText>
            <ns:verifyID>358470757</ns:verifyID>
         </ns:return>
      </ns:askIf3DSEnrolledResponse>
   </soapenv:Body>
</soapenv:Envelope>