Additional Debit of Payment


Makes a new, additional debit on an existing payment. This reserves the amount on the customer’s account. NB: If it is a credit payment, there must be room for the additional debit within the limit.

Input (Literal)

Name Type Occurs Nillable? Description
paymentId id 1..1 No The identity of the payment to which to make an additional debit.
paymentSpec paymentSpec 0..1 No The specification of the additional payment.
createdBy nonEmptyString 0..1 No The username of the person performing the operation.


Name Content Description
ECommerceErrorException ECommerceError     Failed to make an additional debit on the payment. See error for details.


If the customer wants to add a product on an existing order that has not yet been shipped, you can add it with help of additionalDebitOfPayment.

AdditionalDebitOfPayment makes a new, additional debit on an existing payment/order. This reserves the amount on the customer’s account. If it is a credit payment, there must be room for the additional debit within the limit. If the payment method on the other hand is not a card there is an extra room for later debits/purchases when the limit application form was filled by the customer.

It´s also possible to make part debits of a payment. For example, if the customer has ordered 5 products, it’s possible to debit and ship 3 of these products and wait for the rest of them for unknown circumstances. This can also be made from Resurs Merchant Portal.

RestrictionsadditionalDebitOfPayment cannot be done on external payment methods such as Swish and card transactions (VISA/Mastercard) via Nets/d2i

What is paymentSpec?

Click here to read more about paymentSpec The payment details. In it’s simplest form it’s just sum, i.e. totalAmount and totalVatAmount are set, but there are no specLines. If nothing else is said you shall send specLines .
Contains elements as defined in the following table.

Component Type Occurs Nillable? Description
specLines specLine 0..* No The list of payment lines. In the case you’re sending a simple payment, without lines, this parameter should be left empty. Sending payment lines may, or may not, be mandatory, depending on the contract with Resurs Bank.
totalAmount positiveDecimal 1..1 No The total payment amount. The sum of all line amounts (if there are lines supplied) including VAT. If this payment is without lines this is the only value to be set on the payment spec.
totalVatAmount decimal 0..1 Yes The total VAT amount of the payment when there are specification lines supplied. If there are no lines this fileld must be empty (null).

Paymentspec - speclines

Observe that in order to have an invoice with specified order data, make sure to include the speclines in the web service call.

specLines are not mandatory for processing payments.

specLines can vary between start, finalize, credit and annul. It doesn’t matter. Only the sum matter.

specLines make better invoices and help the merchant

The code below shows an example of one paymentSpec row when calling startPaymentSession method

paymentSpec example in bookPayment

Paymentspec - rounding

see Rounding

additionalDebitOfPayment - code example


<soap:Envelope xmlns:soap="" xmlns:xsi="" xmlns:xsd="">   
    <additionalDebitOfPayment xmlns="">       
          <description>Frakt Norge</description>           

Copyright © Resurs Bank AB 2024