Skip to main content
PUT
Update a transaction

Authorizations

Authorization
string
header
required

Tolt API key sent as a bearer token.

Path Parameters

id
string
required
Example:

"txn_fB3egT1sKNVNu3ZYuU1ypYDA"

Body

application/json
amount
integer

The payment amount in the smallest unit of the program currency (cents for USD); percentage commissions are calculated from it.

Required range: -9007199254740991 <= x <= 9007199254740991
status
string | null

Payment status text, such as paid, which is what new transactions get. refunded is not accepted here: refund a transaction with the refund action. null clears the status.

source
string | null

Where the transaction came from, such as stripe or api.

Maximum string length: 255
billing_type
string | null

Kind of payment: subscription for a recurring payment, or one_time.

Maximum string length: 255
charge_id
string | null

Id of the payment in your billing system, such as a Stripe charge id.

Maximum string length: 255
click_id
string | null

Id of the tracked click behind this payment, as returned when listing clicks.

Minimum string length: 1
product_id
string | null

Id of the purchased product in your billing system.

Maximum string length: 255
product_name
string | null

Readable name of the purchased product, such as Pro plan. It is saved as the transaction's product name, which revenue_by_product groups revenue by; flows match on product_id, not on this name. null clears it.

Maximum string length: 255
interval
string | null

Billing period of a subscription payment: month or year.

Maximum string length: 255
created_at
string<date-time>

When the payment happened, as a timestamp with a time zone, for example 2026-03-01T12:00:00Z. Reports and date filters place the transaction on this date.

Response

The updated transaction

success
boolean
required
Example:

true

message
string
required
Example:

"Request successful"

data
object
required