authorizeAndSettle - DIBS Technical Documentation

Permission to send card data must be activated by DIBS. Usage of authorizeAndSettle 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.
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. MAC checksum used to make sure no one has tampered with the information. Use the following formula for this request: X('data&currency&[referenceData&]SecretKey&') 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:authorizeAndSettle>
         <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:method>cc.test</v2:method>
         <!--Optional:-->
         <v2:referenceNo>123A456B789C</v2:referenceNo>
         <!--Optional:-->
         <v2:extra>recurringType=cardholderStored&amp;paRes=paResString&amp;MAC=D6174BCEE45E0287C5C15899E7B2668AC1269845&amp;securityCode=684</v2:extra>
         <!--Alternative markup for extra using CDATA:-->
         <v2:extra><![CDATA[recurringType=cardholderStored&paRes=paResString&MAC=D6174BCEE45E0287C5C15899E7B2668AC1269845&securityCode=684]]></v2:extra>
      </v2:authorizeAndSettle>
   </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:authorizeAndSettleResponse 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>101</ns:resultCode>
            <ns:resultText>settlement_OK</ns:resultText>
            <ns:verifyID>358449834</ns:verifyID>
         </ns:return>
      </ns:authorizeAndSettleResponse>
   </soapenv:Body>
</soapenv:Envelope>