Skip to main content

Cancel PaymentPlan Rows

CancelPaymentPlanRows

Use this method to lower the outstanding contract balance of a delivered payment plan order. The lowered amount is specified by the given list of CancellationRows. A CancellationRow is parsed differently depending on whether the RowNumber attribute is set or not:

  • If the RowNumber attribute is set:
    The outstanding contract balance is lowered by the corresponding original order row amount. The other attributes in the CancellationRow are ignored. (The original order row will show up as cancelled in the Webpay Admin UI.)

  • If the RowNumber attribute is not set:
    A new row will be created using the attributes AmountInclVAT, VATPercent, and Description. The outstanding contract balance is lowered by the given AmountInclVAT. (The new order row will be associated with the contract and will show up in the Webpay Admin UI.)

Note:
If you need to specify an amount that exceeds the outstanding contract balance (i.e. by more than what is left to pay on the contract), you will need to activate a feature. To activate this feature for the client in question, please contact Svea Payments's support.


Input

CancelPaymentPlanRowsRequest

FieldRTypeDescription
ContractNumber*longThe payment plan contract number.
ClientId*longThe webpay client ID.
CancellationRows*List of CancellationRowSee CancellationRow

Note: You are not allowed to send in an ExternalCustomerId by default. To activate this for your account, please contact Svea Payments's support.


Output

CancelPaymentPlanRowsResponse

FieldRTypeDescription
(Empty)--

Structures

CancellationRow

FieldRTypeDescription
AmountInclVat*DecimalAmount including VAT to lower the outstanding amount of the contract by.
VatPercent*DecimalVAT rate in percent.
Description*StringText associated with the resulting row.
RowNumber-IntegerNumber corresponding to an original payment plan order row. If set, the other cancellation row attributes are ignored.