SuspendAccountBetweenDates

Usage



Allows a customer’s payments to be suspended between two dates. 

If no end date is set, then an open-ended suspension will be created.



Parameters

Name

Data Type

Length



Description

User









  • Username

String



Required

Provided by Debitsuccess

  • Password

String



Required

Provided by Debitsuccess

RequestInitiator

String

100

Optional

Optional – allows requesting user to be logged

AccountReferenceNo

String

15

Optional*

Debitsuccess account reference

ExternalAccountReferenceNo

String

50

Optional*

External account reference

StartDate

DateTime



Required

The date on which the suspension shall start**

Must be formatted as YYYY-MM-DD

EndDate

DateTime



Optional

The date on which the suspension shall end.

Must be formatted as YYYY-MM-DD

SuspensionFee

Decimal (10, 2)



Required

Amount to charge for the suspension

SuspensionFeeFrequency

Enum



Required if suspension fee > 0

How often the fee should be charged during the suspension.

OneOff, Weekly, Fortnightly, FourWeekly, Monthly, BiMonthly, Quarterly

StopDirectDebits

Boolean



Optional

If set to True the DD Stop flag will be enabled which will stop any direct debits being made on the account.



This will default to False if left blank.

StopOverdueMail

Boolean



Optional

If set to True a setting will be enabled at the time of suspension to stop any overdue mail being sent to the account holder (if not already).

Validation will check if the account is overdue prior to the suspension and if so overdue mail will not be stopped.

This will default to False if left blank.

* At least one of the following parameters must be supplied: AccountReferenceNo, ExternalAccountReferenceNo

** The start date cannot be before today. If the suspension is set to start today and billing has already commenced the account may go into credit.

Response 

Name

Data Type

Description

DateCreated

DateTime

Date/time message was processed

Id

String

Unique ID for the message

ResponseNotes ()



Collection of validation messages

  • Code

String



  • Note

String



  • NoteType

Enum

Error, Warning, Info

Status

Enum

Failed, Succeed, Unknown

Error Messages

The below table contains all possible response codes that can be returned by SuspendAccountBetweenDates.

Type 

Error Code

Description

Error

02

Invalid user credentials

Error

07

Multiple accounts found with this criteria

Error

10

Account is not active

Error

12016

Missing required reference number. Must provide either ExternalAccountReferenceNo or AccountReferenceNo or both.

Error

13090

Start Date must not be after end date

Error

13091

New suspension ('{0}' - '{1}') overlaps with an existing suspension ('{2}' - '{3}')

Error

13092

No payment schedule found for suspension period

Error

13093

Start Date must not be in the past (When request start date less than current date -7.)

Error

13094

Frequency must be NotSpecified or OneOff when fee is 0.00

Error

13095

Frequency must not be NotSpecified when fee is not 0.00

Error

13096

Fee must not be smaller than 0.00

Warning

14010

Suspension is not aligned with payment schedule and will result in pro rata payments

Warning

14011

Suspension end date '{0}' is after the payment schedule finish date '{1}'.

Warning

14020

DateTime field '{0}' contains time part, but the time is ignored by message. 

Warning

14021

Decimal field '{0}' contains more than 2 decimal points that were ignored by message.

Error

14100

Suspension Start Date cannot be prior to the Account Start Date.

Related Pages



On this page:









© 2021 Debitsuccess. All rights reserved