Update future transaction

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"
  }'

import requests

response = requests.put(
    "https://api.smartretry.com/v1/payments/recurring/future-transactions/update/ABC123",
    headers={
        "Content-Type": "application/json",
        "x-api-key": "YOUR_API_KEY"
    },
    json={
        "future_transaction_id": "FT3D8E1C",
        "recurring_id": "RC9F4A2B",
        "amount": 24.99,
        "scheduled_date": "2026-05-15"
    }
)

print(response.json())

const response = await fetch(
  "https://api.smartretry.com/v1/payments/recurring/future-transactions/update/ABC123",
  {
    method: "PUT",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": "YOUR_API_KEY"
    },
    body: JSON.stringify({
      future_transaction_id: "FT3D8E1C",
      recurring_id: "RC9F4A2B",
      amount: 24.99,
      scheduled_date: "2026-05-15"
    })
  }
);

const data = await response.json();
console.log(data);

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
}

Future transaction status

Charge future transaction

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"
  }'

import requests

response = requests.put(
    "https://api.smartretry.com/v1/payments/recurring/future-transactions/update/ABC123",
    headers={
        "Content-Type": "application/json",
        "x-api-key": "YOUR_API_KEY"
    },
    json={
        "future_transaction_id": "FT3D8E1C",
        "recurring_id": "RC9F4A2B",
        "amount": 24.99,
        "scheduled_date": "2026-05-15"
    }
)

print(response.json())

const response = await fetch(
  "https://api.smartretry.com/v1/payments/recurring/future-transactions/update/ABC123",
  {
    method: "PUT",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": "YOUR_API_KEY"
    },
    body: JSON.stringify({
      future_transaction_id: "FT3D8E1C",
      recurring_id: "RC9F4A2B",
      amount: 24.99,
      scheduled_date: "2026-05-15"
    })
  }
);

const data = await response.json();
console.log(data);

Overview

Payments

Recurring

Future Transactions

Path parameters

Request body

Response

​Path parameters

​Request body

​Response

Path parameters

Request body

Response