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.
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¤cy&[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&paRes=paResString&MAC=D6174BCEE45E0287C5C15899E7B2668AC1269845&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>