Estimate transaction costs

POST https://api.tamio.com/v2/transactions/estimate

Calculates estimated transaction costs including taxes, shipping, and discounts without creating an actual transaction. Useful for checkout previews and price calculations. Requires either an existing customer or new_customer for tax and shipping estimation.

Body Parameters

estimates boolean*

Must be true for estimation mode.

currency string*

Currency code for price estimation.

affiliate string

Affiliate UUID for commission estimation.

convert_prices boolean

Enable currency conversion.

no_discounts boolean

Exclude discounts from estimation.

no_payment_validation boolean

Skip payment method validation.

referrer string

Referring page URL.

coupons array of string

Coupon codes to include in estimation.

products array of ProductItem*

Product line items (1–20).

custom_shipping object

Custom shipping option.

customer object

Existing customer for personalized estimation.

new_customer object

New customer for estimation.

Responses

200 Transaction estimate

Transaction estimate

status integer

transaction object

Estimated transaction breakdown with products, taxes, shipping, totals, and available payment methods.

400 Validation or business-logic error

401 Missing or invalid API key

Create a transaction

Finalise a transaction

/transactions/estimate

1 const response = await fetch("https://api.tamio.com/v2/transactions/estimate", {
2   method: "POST",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     // ... request body
9   })
10 });
11 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/transactions/estimate")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Post.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 request["Content-Type"] = "application/json"
13 request.body = %Q{
14   // ... request body
15 }
16 
17 response = https.request(request)
18 puts response.read_body

Responses

{
  "status": 200,
  "transaction": {}
}

1	const response = await fetch("https://api.tamio.com/v2/transactions/estimate", {
2	method: "POST",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	// ... request body
9	})
10	});
11	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/transactions/estimate")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Post.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12	request["Content-Type"] = "application/json"
13	request.body = %Q{
14	// ... request body
15	}
16
17	response = https.request(request)
18	puts response.read_body