Page Comparison

An account can be suspended due to a customer going on holiday or medical reasons, during this period the regular payments on the account are put on hold. Suspensions can be indefinite–no end date of suspension. When the account is suspended the account is not billed but you may want to collect a suspension fee for administration purposes.

For example, you have a member who will not use the gym for the next two months and you do not want to charge this account regularly but want to have a $3 admin fee for suspension.

Suspension Fees

When creating a suspension, you can either create it with no charge for the customer or specify a suspension fee.
If the customer is going to be charged a fee for the suspension you should pass us the suspension fee and suspension fee frequency (which can be different to the recurring payment frequency) when creating the suspension.
If a suspension is not aligned with the recurring payment schedule then a pro-rata payment will occur.
Even if the suspension fee frequency is different to the account frequency Debitsuccess will still collect any suspension fees owing on the customers next regular payment date

For example, A customer is billed $50 monthly on the 1st of each month. A weekly $5 suspension is created starting on the 1st of February month for 2 weeks between 15th February to 28th February. On the 1st of February, the customer will be debited a pro-rata amount for February:

X days (the number of days in the month) - 14 days (the period of the suspension) * the daily amount the account pays
On the 1st of March, the customer will be debited their normal $50 instalment + $10 for the suspension ($5 * 2 weeks suspension).

Drawio

zoom	1
simple	0
inComment	0
pageId	1299022463
custContentId	1753975555
lbox	1
diagramDisplayName	suspension-fee.drawio
contentVer	4
revision	4
baseUrl	https://debitsuccess.atlassian.net/wiki
diagramName	suspension-fee.drawio
pCenter	0
width	541
links
tbstyle
height	401

Suspend account for the payment cycle

REST API

Use the create Suspension Schedule of Customer Services API to suspend an account for a payment cycle.

Tip

Status

colour	Blue
title	POST

https://<ServerURL>/CustomerServices/v1.0/accounts/{accountId}/suspensionSchedules

minimumEffectiveDate start date of the suspension
SuspensionFeenumberOfPayments Number specify the suspension fee to be collected for a single frequency iteration
Frequency specify the frequency of the suspension fee to be collected. Frequency can be one-off, weekly, fortnightly, four-weekly, monthly, bi-monthly, quarterly
numberOfPayments specify the number of payment instalments to be covered by this suspension schedule. Using this parameter will auto-align the suspension start date to the next billing date

SOAP API

SuspendAccountForNumberOfPaymentCycles is used to suspend an existing account within the Debitsuccess billing system.

AccountReferenceNo
System generated account reference for the customer account to be suspended. At least one of the parameters (AccountReferenceNo, ExternalAccountReferenceNo) must be supplied
AccountCode is returned when you retrieve account details using one of the GetCustomerAccount messages
ExternalAccountReferenceNo
An external unique reference for the customer account to be suspended. At least one of the parameters (AccountReferenceNo, ExternalAccountReferenceNo) must be supplied
minimumEffectiveDate
NumberOfPaymentCycles
SuspensionFee
SuspensionFeeFrequency
DDStop
ODMailStop

Sample request

Code Block

language	xml

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:deb="Debitsuccess.WebServices.WCF" xmlns:deb1="http://schemas.datacontract.org/2004/07/Debitsuccess.WebServices.Core">
   <soapenv:Header/>
   <soapenv:Body>
      <deb:SuspendAccountForNumberOfPaymentCycles>
         <deb:request>
            <deb1:User>
               <deb1:Password>testPassword</deb1:Password>
               <deb1:Username>testUser</deb1:Username>
            </deb1:User>
            <deb1:AccountReferenceNo>ABC12345</deb1:AccountReferenceNo>
            <deb1:ExternalAccountReferenceNo></deb1:ExternalAccountReferenceNo>
            <deb1:MinimumEffectiveDate>2022-03-31</deb1:MinimumEffectiveDate>
            <deb1:NumberOfPaymentCycles>5</deb1:NumberOfPaymentCycles>
            <deb1:SuspensionFee>10</deb1:SuspensionFee>
            <deb1:SuspensionFeeFrequency>Monthly</deb1:SuspensionFeeFrequency>
            <deb1:DDStop>true</deb1:DDStop>
            <deb1:ODMailStop>true</deb1:ODMailStop>
         </deb:request>
      </deb:SuspendAccountForNumberOfPaymentCycles>
   </soapenv:Body>
</soapenv:Envelope>

Sample response

Code Block

language	xml

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <ActivityId CorrelationId="9603581e-c4c8-4a36-ad63-5cbf54e1ad7a" xmlns="http://schemas.microsoft.com/2004/09/ServiceModel/Diagnostics">00000000-0000-0000-0000-000000000000</ActivityId>
   </s:Header>
   <s:Body>
      <SuspendAccountForNumberOfPaymentCyclesResponse xmlns="Debitsuccess.WebServices.WCF">
         <SuspendAccountForNumberOfPaymentCyclesResult xmlns:a="http://schemas.datacontract.org/2004/07/Debitsuccess.WebServices.Core" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <a:DateCreated>2020-07-01T14:43:36.230952+12:00</a:DateCreated>
            <a:Id>2708102e-2a9d-43ae-9482-d887452b1918</a:Id>
            <a:ResponseNotes>
               <a:ResponseMessageNote>
                  <a:Code>00</a:Code>
                  <a:Note>Success</a:Note>
                  <a:NoteType>Info</a:NoteType>
               </a:ResponseMessageNote>
            </a:ResponseNotes>
            <a:Status>Succeed</a:Status>
            <a:ScheduleId>48132090</a:ScheduleId>
            <a:SuspensionEndDate>2022-09-22T00:00:00</a:SuspensionEndDate>
            <a:SuspensionStartDate>2022-04-23T00:00:00</a:SuspensionStartDate>
         </SuspendAccountForNumberOfPaymentCyclesResult>
      </SuspendAccountForNumberOfPaymentCyclesResponse>
   </s:Body>
</s:Envelope>

Suspend account between dates

REST API

Use the create Suspension Schedule of Customer Services API to suspend an account for a period.

Tip

Status

colour	Blue
title	POST

https://<ServerURL>/CustomerServices/v1.0/accounts/{accountId}/suspensionSchedules

minimumEffectiveDate start date of the suspension
SuspensionFee specify the suspension fee to be collected for a single frequency iteration
Frequency specify the frequency of the suspension fee to be collected. Frequency can be one-off, weekly, fortnightly, four-weekly, monthly, bi-monthly, quarterly
suspensionScheduleEndDate specify the end date of the suspension schedule in the "YYYY-MM-DD" format

SOAP API

SuspendAccountBetweenDates is used to suspend an existing account within the Debitsuccess billing system.

AccountReferenceNo
System generated account reference for the customer account to be suspended. At least one of the parameters (AccountReferenceNo, ExternalAccountReferenceNo) must be supplied
AccountCode is returned when you retrieve account details using one of the GetCustomerAccount messages
ExternalAccountReferenceNo
An external unique reference for the customer account to be suspended. At least one of the parameters (AccountReferenceNo, ExternalAccountReferenceNo) must be supplied
EndDate
StartDate
SuspensionFee
SuspensionFeeFrequency
DDStop
ODMailStop

Sample request

Code Block

language	xml

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:deb="Debitsuccess.WebServices.WCF" xmlns:deb1="http://schemas.datacontract.org/2004/07/Debitsuccess.WebServices.Core">
   <soapenv:Header/>
   <soapenv:Body>
      <deb:SuspendAccountBetweenDates>
         <deb:request>
            <deb1:User>
               <deb1:Password>testPassword</deb1:Password>
               <deb1:Username>testUser</deb1:Username>
            </deb1:User>
            <deb1:AccountReferenceNo>ABC12345</deb1:AccountReferenceNo>
            <deb1:ExternalAccountReferenceNo></deb1:ExternalAccountReferenceNo>
            <deb1:EndDate>2021-03-31</deb1:EndDate>
            <deb1:StartDate>2020-07-30</deb1:StartDate>
            <deb1:SuspensionFee>10</deb1:SuspensionFee>
            <deb1:SuspensionFeeFrequency>Monthly</deb1:SuspensionFeeFrequency>
            <deb1:DDStop>true</deb1:DDStop>
            <deb1:ODMailStop>true</deb1:ODMailStop>
         </deb:request>
      </deb:SuspendAccountBetweenDates>
   </soapenv:Body>
</soapenv:Envelope>

Sample response

Code Block

language	xml

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <ActivityId CorrelationId="a8a1e872-074e-43aa-8aa8-4e9772c8be9e" xmlns="http://schemas.microsoft.com/2004/09/ServiceModel/Diagnostics">00000000-0000-0000-0000-000000000000</ActivityId>
   </s:Header>
   <s:Body>
      <SuspendAccountBetweenDatesResponse xmlns="Debitsuccess.WebServices.WCF">
         <SuspendAccountBetweenDatesResult xmlns:a="http://schemas.datacontract.org/2004/07/Debitsuccess.WebServices.Core" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
            <a:DateCreated>2020-07-01T15:46:12.3133592+12:00</a:DateCreated>
            <a:Id>0f287d65-0621-48b2-b501-cb0874de47f7</a:Id>
            <a:ResponseNotes>
               <a:ResponseMessageNote>
                  <a:Code>14010</a:Code>
                  <a:Note>Suspension is not aligned with payment schedule and will result in pro rata payments.</a:Note>
                  <a:NoteType>Warning</a:NoteType>
               </a:ResponseMessageNote>
               <a:ResponseMessageNote>
                  <a:Code>00</a:Code>
                  <a:Note>Success</a:Note>
                  <a:NoteType>Info</a:NoteType>
               </a:ResponseMessageNote>
            </a:ResponseNotes>
            <a:Status>Succeed</a:Status>
            <a:ScheduleId>48132091</a:ScheduleId>
            <a:SuspensionEndDate>2021-03-31T00:00:00</a:SuspensionEndDate>
            <a:SuspensionStartDate>2020-07-30T00:00:00</a:SuspensionStartDate>
         </SuspendAccountBetweenDatesResult>
      </SuspendAccountBetweenDatesResponse>
   </s:Body>
</s:Envelope>

Version	Old Version 25	New Version Current
Changes made by	chitra.b (Unlicensed)	chitra.b (Unlicensed)
Saved on	Jun 03, 2021	Jun 04, 2021

Versions Compared

Key

Suspension Fees

Suspend account for the payment cycle

REST API

SOAP API

Sample request

Sample response

Suspend account between dates

REST API

SOAP API

Sample request

Sample response

Related Articles