Theme switcher

Update Recurring 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.

recurringScheduleIdstring

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

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

Pass false to deactivate the Recurring Payment schedule.

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

This is the ISO 4217 currency code. Use "036" for Australian dollar, "840" for United States dollar, "826" for Pound sterling. Please refer https://en.wikipedia.org/wiki/ISO_4217 for list of all currency codes.

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

transactionReferencestring

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

tokenstring

The token value of the credit card.

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.

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?