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.

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://api.smartretry.com/v1/payments/recurring/future-transactions/status/ABC123?future_transaction_id=FT3D8E1C' \
  --header 'x-api-key: YOUR_API_KEY'

​
Path parameters

​
terminal_friendly_id
string
required
Your 6-character terminal identifier.

​
Query parameters

​
future_transaction_id
string
required
The 8-character identifier of the future transaction to look up.

​
Response

​
future_transaction_id
string
Unique identifier of this future transaction (8 characters).
​
recurring_id
string
Identifier of the recurring series this transaction belongs to (8 characters).
​
scheduled_date
string
The date this payment is scheduled to be processed, in YYYY-MM-DD format.
​
sequence_number
integer
The position of this payment within the series (e.g., 2 means it is the second payment in the schedule).
​
amount
number
Amount to be charged in major currency units (e.g., 19.99).
​
currency
string
ISO 4217 currency code for this payment.
​
status
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.
​
executed_transaction
string
The transaction_id of the transaction that executed this future payment. Present only when status is completed.
​
executed_at
string
ISO 8601 timestamp of when this future transaction was executed. Present only when status is completed.
​
notes
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.