Future transaction status

GET /v1/payments/recurring/future-transactions/status/{terminal_friendly_id} Returns the details of a specific future transaction - its scheduled date, amount, currency, and current processing status. Use this endpoint to check the state of an individual upcoming payment within a recurring series.

curl --request GET \
  --url 'https://terminal.smartretry.com/v1/payments/recurring/future-transactions/status/ABC123' \
  --header 'x-api-key: YOUR_API_KEY'

import requests

response = requests.get(
    "https://terminal.smartretry.com/v1/payments/recurring/future-transactions/status/ABC123",
    headers={"x-api-key": "YOUR_API_KEY"}
)

print(response.json())

const response = await fetch(
  "https://terminal.smartretry.com/v1/payments/recurring/future-transactions/status/ABC123",
  {
    method: "GET",
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

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

Path parameters

string

required

Your 6-character terminal identifier.

Response

string

Unique identifier of this future transaction (8 characters).

string

Identifier of the recurring series this transaction belongs to (8 characters).

string

The date this payment is scheduled to be processed, in YYYY-MM-DD format.

integer

The position of this payment within the series (e.g., 2 means it is the second payment in the schedule).

number

Amount to be charged in major currency units (e.g., 19.99).

string

ISO 4217 currency code for this payment.

string

Current status of this future transaction. One of:

pending - scheduled and waiting to be processed.
processing - currently being executed.
completed - successfully processed.
failed - processing attempted but unsuccessful.
cancelled - this specific occurrence was cancelled.

string

The transaction_id of the transaction that executed this future payment. Present only when status is completed.

string

ISO 8601 timestamp of when this future transaction was executed. Present only when status is completed.

string

Optional notes associated with this future transaction.

Example response

{
  "future_transaction_id": "FT3D8E1C",
  "recurring_id": "RC9F4A2B",
  "scheduled_date": "2026-05-01",
  "sequence_number": 2,
  "amount": 19.99,
  "currency": "USD",
  "status": "pending"
}

To see all upcoming payments for a series at once, use the recurring status endpoint - it includes the full future_transactions array in a single response.

Overview

Payments

Recurring