Charge future transaction

POST /v1/payments/recurring/future-transactions/charge/{terminal_friendly_id} Processes a future transaction right away, before its scheduled date. Use this endpoint when you need to execute an upcoming payment early - for example, when a customer upgrades their plan mid-cycle and you want to collect the prorated amount immediately.

This endpoint executes the payment before its scheduled date. Once processed, the transaction moves to completed status and will not be charged again on its original scheduled date.

Safe retries for this POST endpoint use the Idempotency-Key header. Reuse the same key only when retrying the exact same request body. See Idempotency.

curl --request POST \
  --url https://terminal.smartretry.com/v1/payments/recurring/future-transactions/charge/ABC123 \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'Idempotency-Key: future-charge-20260401-001' \
  --data '{
    "future_transaction_id": "FT3D8E1C",
    "recurring_id": "RC9F4A2B"
  }'

import requests

response = requests.post(
    "https://terminal.smartretry.com/v1/payments/recurring/future-transactions/charge/ABC123",
    headers={
        "Content-Type": "application/json",
        "x-api-key": "YOUR_API_KEY",
        "Idempotency-Key": "future-charge-20260401-001"
    },
    json={
        "future_transaction_id": "FT3D8E1C",
        "recurring_id": "RC9F4A2B"
    }
)

print(response.json())

const response = await fetch(
  "https://terminal.smartretry.com/v1/payments/recurring/future-transactions/charge/ABC123",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": "YOUR_API_KEY",
      "Idempotency-Key": "future-charge-20260401-001"
    },
    body: JSON.stringify({
      future_transaction_id: "FT3D8E1C",
      recurring_id: "RC9F4A2B"
    })
  }
);

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

Path parameters

string

required

Your 6-character terminal identifier.

Request body

string

required

The 8-character identifier of the future transaction to charge immediately.

string

required

The 8-character identifier of the recurring series this future transaction belongs to.

number

Override the scheduled amount for this charge only, in major currency units (e.g., 19.99 for $19.99). Minimum 0.01, maximum 999999.99. If omitted, the amount defined on the future transaction is used.

Response

string

Unique identifier of the resulting transaction (8 characters).

string

Order identifier for the resulting transaction (8 characters).

string

The identifier of the recurring series (8 characters).

string

The identifier of the future transaction that was charged (8 characters).

boolean

true if the charge was authorized. false if the transaction was declined. Always check this field - a 200 status does not guarantee the payment succeeded.

Example response

{
  "transaction_id": "TX8A3F2C",
  "order_id": "OR7B9E1D",
  "recurring_id": "RC9F4A2B",
  "future_transaction_id": "FT3D8E1C",
  "accepted": true
}

Before charging early, use the future transaction status endpoint to confirm the transaction is still in pending status. Attempting to charge a transaction that is already completed, processing, or cancelled returns an error.

Overview

Payments

Recurring

Future Transactions

Path parameters

Request body

Response

​Path parameters

​Request body

​Response

Path parameters

Request body

Response