subscribeAndSettle

Creates a new payment and settles it using a previously authorized payment. Can be used for e.g. subscriptions.

This feature must be enabled manually by DIBS.

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.
verifyID * This should contain the verifyID which was made using the card number with which you want to create additional authorizations.
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.
ip * The IP number of the customer. If the IP address is not available, please send the empty string.
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.
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 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

Below is an example of a subscribeAndSettle request using SOAP.

<soap:Envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:v2="https://securedt.dibspayment.com/DTServerModuleService/v2">
   <soap:Header/>
   <soap:Body>
      <v2:subscribeAndSettle>
         <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:verifyID>358446466</v2:verifyID>
         <v2:data>12a:pen:2:100:10b:pencil:1:50:</v2:data>
         <v2:ip>10.0.0.0</v2:ip>
         <v2:currency>SEK</v2:currency>
         <!--Optional:-->
         <v2:extra>&amp;MAC=D6174BCEE45E0287C5C15899E7B2668AC1269845</v2:extra>
      </v2:subscribeAndSettle>
   </soap:Body>
</soap:Envelope>

The following is an example of a response:

<soapenv:Envelope xmlns:soapenv="http://www.w3.org/2003/05/soap-envelope">
   <soapenv:Body>
      <ns:subscribeAndSettleResponse 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>358448024</ns:verifyID>
         </ns:return>
      </ns:subscribeAndSettleResponse>
   </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