Theme switcher

Get Recurring Payment

Path Parameters

agreementIdstring

Search based on the unique agreement ID provided by TNS.

Response

200
Object

Response Attributes

recurringPaymentSetupIdstring

This is the unique identifier of the Recurring Payment Schedule in our system

merchantIdstring

This is the unique identifier of the merchant in our system.

merchantTimeZonestring

Based on the timezone, the execution time of the recurring payment is calculated. The value of this field aligns with the geographic area's standard time and daylight saving adjustments. It is formatted as "Country/Region" and defaults to the merchant's timezone.

startDatestring

This is the effective start date of the schedule

endDatestring

This is the effective date on which this recurring schedule becomes invalid.

nextRunDatestring

This is the upcoming effective date on which the recurring payment will be executed.

lastRunDatestring

This is the date of the last executed recurring payment.

agreementIdstring

This is an auto generated field. Once the schedule contract is confirmed, this id is generated.

frequencyTypestring

This indicates frequency of the schedule for this recurring payment.

paymentMethodstring

The type of tender used for the transaction.

currencyCodestring

This is the 3 digit ISO 4217 numeric Currency Code.

paymentDetailsarray
frequencynumber

This indicates the frequency of the recurring payment. For example, if the value is 2 and the frequency type is 'DAILY', then the card will be charged every 2 days.

monthOfYearstring

This specifies the month of the year to charge the card, applicable when the frequency type is 'YEARLY'. Accepted values range from 1 to 12, corresponding to January through December.

dateOfMonthnumber

This specifies the date of the month on which to charge the card, applicable when the frequency type is 'MONTHLY' or 'YEARLY'. Accepted values range from 1 to 28 to accommodate all months.

dayOfWeekstring

This specifies the day of the week on which to charge the card, applicable when the frequency type is 'WEEKLY'. Accepted values range from 1 to 7, where 1 corresponds to Sunday and the numbers follow sequentially through the week.

weekDaysOnlyboolean

This indicates the system to perform this Recurring Payment Schedule only on the week days. Applicable when the frequencyType is 'DAILY'.

merchantNamestring

The name of the merchant as it appears in the merchant portal.

deletedboolean

This field indicates whether the Recurring Payment Schedule has been deleted.

pausedboolean

This field indicates whether the Recurring Payment Schedule has been paused.

activeboolean

This field indicates whether the Recurring Payment Schedule is active.

400
Object

Bad Request

Response Attributes

errorsarray

List of error messages.

401
Object

Unauthorized

404
Object

The server is temporarily unavailable. Please try again later.

500
Object

Internal Server Error

Response Attributes

timestampstring

Date time request received.

statusnumber

HTTP Status code.

errorstring

Error message.

pathstring

API.

Was this section helpful?

Base URL

Production:

Sandbox:

GET

/

Select
1

Response

Was this section helpful?