tolt.js
Guides / How To
Customers
Clicks
Commissions
Transactions
Create Transaction
This endpoint creates a transaction.
curl -X POST 'https://api.tolt.com/v1/transactions' \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
"amount": 9999,
"customer_id": "cust_dK9bzRGn46BhVgNFHD6fDgXW",
"billing_type": "subscription",
"charge_id": "ch_9bzRGn46BhVgNFHD6fDgXW",
"click_id": "clk_7mbzRGn46BhVgNFHD6fDgXW",
"product_id": "prod_123",
"product_name": "Premium Plan",
"source": "stripe",
"interval": "month",
"created_at": "2025-01-15T14:30:00.000Z"
}'
{
"success": true,
"data": [
{
"id": "txn_eK9bzRGn46BhVgNFHD6fDgXW",
"status": "paid",
"amount": 14999,
"amount_excluding_tax": null,
"tax": null,
"currency": "USD",
"payment_currency": "USD",
"payment_amount": null,
"payment_amount_excluding_tax": null,
"payment_tax": null,
"charge_id": "ch_9bzRGn46BhVgNFHD6fDgXW",
"metadata": null,
"source": "stripe",
"partner_id": "d30a0807-a0f0-44fc-a38e-2c3a1f640f07",
"organization_id": "org_JE3mfYNL9ci7sFaJazAv2",
"program_id": "prg_YRsbPDAKhWfdqJbFACheh",
"click_id": "clk_7mbzRGn46BhVgNFHD6fDgXW",
"customer_id": "cust_dK9bzRGn46BhVgNFHD6fDgXW",
"created_at": "2025-04-25T09:35:53.025Z",
"updated_at": "2025-04-25T09:36:10.740Z",
"amount_including_tax": null,
"payment_amount_including_tax": null,
"product_ids": [],
"interval": "year",
"billing_type": "subscription",
"product_names": [],
"conversion_rate": null
}
]
}
Base URL https://api.tolt.com
Body Parameters
The transaction amount in cents
The ID of the customer associated with this transaction
The billing type. Valid values are: ‘one_time’ or ‘subscription’
Associated charge identifier
Associated click identifier
ISO 8601 timestamp of when the transaction was created
The ID of the product associated with this transaction
The name of the product associated with this transaction
Source of the transaction
For subscription billing type. Valid values are: ‘month’ or ‘year’
Response
Whether the request was successful
Unique identifier for the transaction
Transaction amount in cents
ID of the associated customer
The billing type
Transaction amount excluding tax in cents
Transaction amount including tax in cents
Tax amount in cents
Currency code for the transaction amount
Currency used for the payment
Payment amount in cents
Payment amount excluding tax in cents
Payment amount including tax in cents
Payment tax amount in cents
Associated charge identifier
Associated click identifier
ISO 8601 timestamp of creation
Source of the transaction
Status of the transaction
Optional metadata
Subscription interval
ISO 8601 timestamp of last update
List of product identifiers associated with the transaction
List of product names associated with the transaction
Conversion rate if currency conversion is involved
ID of the partner associated with the transaction
Program ID the transaction belongs to
Organization ID
curl -X POST 'https://api.tolt.com/v1/transactions' \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
"amount": 9999,
"customer_id": "cust_dK9bzRGn46BhVgNFHD6fDgXW",
"billing_type": "subscription",
"charge_id": "ch_9bzRGn46BhVgNFHD6fDgXW",
"click_id": "clk_7mbzRGn46BhVgNFHD6fDgXW",
"product_id": "prod_123",
"product_name": "Premium Plan",
"source": "stripe",
"interval": "month",
"created_at": "2025-01-15T14:30:00.000Z"
}'
{
"success": true,
"data": [
{
"id": "txn_eK9bzRGn46BhVgNFHD6fDgXW",
"status": "paid",
"amount": 14999,
"amount_excluding_tax": null,
"tax": null,
"currency": "USD",
"payment_currency": "USD",
"payment_amount": null,
"payment_amount_excluding_tax": null,
"payment_tax": null,
"charge_id": "ch_9bzRGn46BhVgNFHD6fDgXW",
"metadata": null,
"source": "stripe",
"partner_id": "d30a0807-a0f0-44fc-a38e-2c3a1f640f07",
"organization_id": "org_JE3mfYNL9ci7sFaJazAv2",
"program_id": "prg_YRsbPDAKhWfdqJbFACheh",
"click_id": "clk_7mbzRGn46BhVgNFHD6fDgXW",
"customer_id": "cust_dK9bzRGn46BhVgNFHD6fDgXW",
"created_at": "2025-04-25T09:35:53.025Z",
"updated_at": "2025-04-25T09:36:10.740Z",
"amount_including_tax": null,
"payment_amount_including_tax": null,
"product_ids": [],
"interval": "year",
"billing_type": "subscription",
"product_names": [],
"conversion_rate": null
}
]
}
curl -X POST 'https://api.tolt.com/v1/transactions' \
-H 'Authorization: Bearer <API_KEY>' \
-H 'Content-Type: application/json' \
-d '{
"amount": 9999,
"customer_id": "cust_dK9bzRGn46BhVgNFHD6fDgXW",
"billing_type": "subscription",
"charge_id": "ch_9bzRGn46BhVgNFHD6fDgXW",
"click_id": "clk_7mbzRGn46BhVgNFHD6fDgXW",
"product_id": "prod_123",
"product_name": "Premium Plan",
"source": "stripe",
"interval": "month",
"created_at": "2025-01-15T14:30:00.000Z"
}'
{
"success": true,
"data": [
{
"id": "txn_eK9bzRGn46BhVgNFHD6fDgXW",
"status": "paid",
"amount": 14999,
"amount_excluding_tax": null,
"tax": null,
"currency": "USD",
"payment_currency": "USD",
"payment_amount": null,
"payment_amount_excluding_tax": null,
"payment_tax": null,
"charge_id": "ch_9bzRGn46BhVgNFHD6fDgXW",
"metadata": null,
"source": "stripe",
"partner_id": "d30a0807-a0f0-44fc-a38e-2c3a1f640f07",
"organization_id": "org_JE3mfYNL9ci7sFaJazAv2",
"program_id": "prg_YRsbPDAKhWfdqJbFACheh",
"click_id": "clk_7mbzRGn46BhVgNFHD6fDgXW",
"customer_id": "cust_dK9bzRGn46BhVgNFHD6fDgXW",
"created_at": "2025-04-25T09:35:53.025Z",
"updated_at": "2025-04-25T09:36:10.740Z",
"amount_including_tax": null,
"payment_amount_including_tax": null,
"product_ids": [],
"interval": "year",
"billing_type": "subscription",
"product_names": [],
"conversion_rate": null
}
]
}