Authorize

The function authorize performs the first part of a credit card transaction (the authorization). The authorization includes e.g. credit- and debit-card control and reservation of the required amount for later capture.

Permission to send card data must be activated by DIBS. Usage of authorize 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. See the MAC page for more information.

*: Always validated by DIBS

Example

Below is an example of the authorize request using SOAP.

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:v2="https://secure.incab.se/DTServerModuleService/v2">
   <soapenv:Header/>
   <soapenv:Body>
      <v2:authorize>
         <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>&amp;MAC=D6174BCEE45E0287C5C15899E7B2668AC1269845&securityCode=684</v2:extra>
      </v2:authorize>
   </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