Theme switcher

Update Recurring Token Payment

Body Parameters

merchantIdstring Required

This the unique identifier of the merchant in our system.

timezonestring

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.

agreementIdstring Required

The agreementId you want to update as returned when you first setup the recurring agreement.

startDatestring Required

This is the effective start date of the Recurring Payment Schedule in UTC, formatted as YYYY-MM-DD.

endDatestring Required

This is the effective date on which this Recurring Payment Schedule becomes invalid. This value is in UTC, formatted as YYYY-MM-DD.

paymentMethodstring

The type of tender used for the transaction.

Enum values:
CREDITCARDTOKEN
paymentDetailsarray
pausedboolean

Pause the Recurring Payment schedule.

activeboolean

If the agreement type should remain active or be marked as inactive.

frequencyTypestring

This indicates frequency of the schedule for this Recurring Payment Schedule.

Enum values:
YEARLY
Charge the card annually on the given month and day of the year.
MONTHLY
Charge the card every month on the given day of the month.
WEEKLY
Charge the card every week on the given day of the week.
DAILY
Charge the card Daily.
frequencynumber

This indicates the frequency of the Recurring Payment Schedule. For example, if the value is 2 and the frequency type is 'Weekly', then the card will be charged every 2 weeks.

monthOfYearstring | null

This specifies the month of the year to charge the card, applicable when the frequency type is 'YEARLY'.

Enum values:
JANUARYFEBRUARYMARCHAPRILMAYJUNEJULYAUGUSTSEPTEMBEROCTOBER
... 3 other enums
Empty value:
True
dateOfMonthnumber

This indicates the specific day of the month when the card will be charged.

dayOfWeekstring

This specifies the day of the week on which to charge the card, applicable when the frequency type is 'WEEKLY'.

Enum values:
SUNDAYMONDAYTUESDAYWEDNESDAYTHURSDAYFRIDAYSATURDAY
Empty value:
True
weekDaysOnlyboolean

Set false if the Recurring Payment schedule is expected to run on weekdays only. Applecable if frequency type is 'WEEKLY'.

Response

200
Object

Response Attributes

recurringPaymentSetupIdstring

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

merchantIdstring

This the unique identifier of the merchant in our system.

merchantTimeZonestring

The merchant timezone configured for the recurring agreement.

createdDatestring

Recurring payment setup creation date.

updatedDatestring

Recurring payment setup last modified date.

agreementIdstring

This is an auto generated field. Once the schedule contract is confirmed, this id is generated. For update always a new agreement Id is generated.

lastRunDatestring

The last run date of a recurring transaction for this agreement.

nextRunDatestring

The next scheduled run date for this agreement

resumePaymentOnstring

When the recurring agreement is due to resume

isDeletedstring

If the agreement is deleted and no longer active.

isPausedstring

If the agreement is currently paused

isActivestring

If the agreement is currently active

createdBystring

The merchant account that the agreement was created on

updatedBystring

If the agreement has been updated

frequencyTypestring

The frequency type of the recurring transaction

recurringSchedulestring

The unique id of a recurringSchedule

countryCodestring

The countryCode of the recurring transaction for the merchant

currencyCodestring

The numeric currency code of the agreement id.

levelIdstring

The reporting level id that the recurring transaction is related to.

transactionStatusstring

The transaction status of the agreement

transactionReferencestring

The identifier for the transaction in your system formatted as a string.

tokenstring

The token value of the credit card.

paymentMethodTypestring

The type of payment method being used for the recurring transaction

first6string

The masked card number for the agreement type

cardHolderNamestring

The cardholder name for the agreement type if supplied

expirystring

the MMYY for the expiry of the card

transactionAmountstring

This is the total amount of the transaction in the designated currency in decimal

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

Request date and time.

statusnumber

HTTP Status code.

errorstring

Error message.

pathstring

API path.

Was this section helpful?

Base URL

Production:

Sandbox:

POST

/

Select
1

Response

Was this section helpful?