Skip to main content

Documentation Index

Fetch the complete documentation index at: https://www.smartretry.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

PUT /v1/payments/recurring/future-transactions/update/{terminal_friendly_id} Updates a single future transaction within a recurring series. You can override the charge amount for that specific occurrence, reschedule it to a different date, or both. Changes apply only to the targeted transaction - the rest of the series schedule is unaffected.
To change the default amount or schedule for all future payments in a series, use the recurring update endpoint instead.
curl --request PUT \
  --url https://api.smartretry.com/v1/payments/recurring/future-transactions/update/ABC123 \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "future_transaction_id": "FT3D8E1C",
    "recurring_id": "RC9F4A2B",
    "amount": 24.99,
    "scheduled_date": "2026-05-15"
  }'

​
Path parameters

​
terminal_friendly_id
string
required
Your 6-character terminal identifier.

​
Request body

​
future_transaction_id
string
required
The 8-character identifier of the future transaction to update.
​
recurring_id
string
required
The 8-character identifier of the recurring series this future transaction belongs to.
​
amount
number
Override the charge amount for this specific occurrence only, in major currency units (e.g., 24.99 for $24.99). Does not affect the default series amount or other future transactions.
​
scheduled_date
string
Reschedule this occurrence to a new date in YYYY-MM-DD format. Must be a future date. Does not shift subsequent payments - only this specific occurrence is moved.

​
Response

​
future_transaction_id
string
The identifier of the updated future transaction (8 characters).
​
accepted
boolean
true if the update was applied successfully.
Example response
{
  "future_transaction_id": "FT3D8E1C",
  "accepted": true
}