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¤cy&[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>&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>