Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Status
colourGreen
titleGATEWAY ONLY

Usage


Excerpt

Returns the schedule with payment status found in between the date range provided in the request.


Note

Since this API call does not have pagination, our recommendation is to apply smaller date ranges (not more than 30 days) otherwise, you may receive timeout errors.


Parameters

Name

Data Type

Length


Description

User





  • Username

String


Required

Provided by Debitsuccess

  • Password

String


Required

Provided by Debitsuccess

RequestInitiator

String

100

Optional

Allows requesting user to be logged

ContractPrefix

String

6

Optional

If not provided, records from all facility accounts associated with the WS user will be extracted

Status

Enum


Optional

  • All (default value)

Unattempted
  • Pending

  • Retry

  • Failed

  • Cleared

  • Settled

  • Unbillable

CreditControl

For descriptions of these statuses, see Statuses in Debitsuccess Systems.

StartDate

DateTime


Required

Start date and end date must be within

1 month

31 days

EndDate

DateTime


Optional

If EndDate is not provided, it will default to today date

Response 

Name

Data Type

Description

DateCreated

Datetime

Date/time message was processed

Id

String

Unique ID for the message

ResponseNotes()



  •  Code

String


  • Note

String


  • NoteType

Enum

Error, Warning, Info

Status

Enum

Failed, Success, Unknown

PaymentSchedule

PaymentSchedules()

  1. PayScheduleWithStatus()



  • ContractPrefix

String


  • AccountRef

String


  • Description

String(50)

Unique identifier

  • ExternalIdentifier

String(50)


  • Installment

Number

Date of Status of Payment

  • PaymentStatus

String(15)

  • Pending

  • Retry

  • Failed

  • Cleared

  • Settled

  • Unbillable

For descriptions of these statuses, see Statuses in Debitsuccess Systems.

  • ScheduleId

Integer


  • StartDate

Datetime


  • StatusDate

Datetime


  • ErrorCode

String

Note: Only returned for failed Payments.
Account Closed
Authority Stopped
Card Expired
Chargeback
Declined
Insufficient Funds
Invalid Account
Lost / Stolen Card
No Authority
Restricted Card

Error Messages

Type

Error Code

Error Message

Error

14033

Invalid Start date - start date must be less than end date.

Error

14101

Invalid Start Date - start date must not be empty or in the future

Error

14104

Invalid Date range -

a

start date and end date must be within

1 month

31 days.

Error

13001

Invalid Contract Prefix

Error

100

Invalid enum value ‘<invalid status>' cannot be deserialized into type 'Debitsuccess.WebServices.Core.DocketStatus'. Ensure that the necessary enum values are present and are marked with EnumMemberAttribute attribute if the type has DataContractAttribute attribute.

Error

100

There was an error deserializing the object of type Debitsuccess.WebServices.Core.RequestMessages.RequestGetPaymentHistoryByStatusForDateRange. The value '' cannot be parsed as the type 'DateTime'.

Related Pages

Filter by label (Content by label)
showLabelsfalse
spacesDDE
showSpacefalse
sorttitle
typepage
cqllabel = "getcustomerpaymentbystatusfordaterange" and ancestor = "986156090"
labelsdocumentation-space-sample



Panel

On this page:

Table of Contents


Panel
titleREST API

GET Payment Status