Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 24 Next »

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 is not going to use the gym for the next two months and you do not want to charge this account regularly but want to have $3 admin fee for suspension.

Suspension Fees

  • When creating a suspension you can either create it with no charge for the customer or you can specify a fee for the suspension.

  • 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 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 the month of 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 after the customer will be debited their normal $50 instalment + $10 for the suspension ($5 * 2 weeks suspension).

Suspend account for the payment cycle

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

<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

<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

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

<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

<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>

On this page:

  • No labels

© 2021 Debitsuccess. All rights reserved