Create a transaction

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

Creates a new transaction with full customer information, product details, shipping options, and fulfillment configuration. Supports both existing customers (via customer) and new customers (via new_customer). At least one of them must be provided. Products can reference catalog items by id, variant, or pack, or use custom price and name for ad-hoc line items.

Body Parameters

affiliate string

Affiliate UUID for commission tracking.

create_transaction boolean

Must be true to proceed.

true

currency string*

Currency code. Null defaults to account base currency.

locale string

Language preference for communications.

referrer string

Referring page URL.

convert_prices boolean

Enable automatic currency conversion.

no_discounts boolean

Disable all discount applications.

coupons array of string

Coupon codes to apply.

products array of ProductItem*

Product line items (1–20).

shipping object

Shipping configuration.

fulfillment_options object

Fulfillment automation flags.

customer object

Existing customer reference.

new_customer object

New customer to create during checkout.

custom_fields object

Custom checkout fields.

Responses

200 Transaction created

Transaction created

status integer

transaction Transaction

400 Validation or business-logic error

401 Missing or invalid API key

Estimate transaction costs

/transactions/create

1 const response = await fetch("https://api.tamio.com/v2/transactions/create", {
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/create")
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": {
    "id": "string",
    "object": "transaction",
    "products": [],
    "customer_information": {},
    "payments": {},
    "locale": "string",
    "instalments": {},
    "taxes": {},
    "shipping": {},
    "has_subscriptions": false,
    "currency": "string",
    "merchant": {},
    "totals": {},
    "discounts": {},
    "invoice": {},
    "order_id": 0,
    "affiliate": {},
    "active_instalment_plan": {},
    "payout": {}
  }
}

1	const response = await fetch("https://api.tamio.com/v2/transactions/create", {
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/create")
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