Finalise a transaction

POST https://api.tamio.com/v2/transactions/finalise/{uuid}

Finalises an existing transaction by selecting a payment method, shipping option, and optionally a subscription plan. Triggers payment processing and completes the purchase flow.

Warning: It is strongly recommended to use the Tamio SDK for finalising transactions, as it automatically loads and configures the required payment integrations (Stripe, Mollie, GoCardless, etc.). Calling this endpoint directly requires you to handle payment provider setup and 3D Secure flows manually.

Path Parameters

uuid string*

UUID of the transaction to finalise.

Body Parameters

plan string

Subscription plan identifier for recurring billing setup. Null for one-time purchases.

redirect string

URL to redirect the customer to after successful payment.

payment string

Payment method identifier. Null for automatic detection.

shipping string

Shipping method UUID for delivery configuration.

Responses

200 Transaction finalised successfully. Returns the full transaction object with ...

Transaction finalised successfully. Returns the full transaction object with charge details, selected payment, and instalment information.

status integer

transaction object

400 Validation or business-logic error.

Validation or business-logic error.

Code	Description
1002	Transaction not found.
403	Not authorised to finalise this transaction.
10015	A sale for this transaction already exists.
10016	This transaction is already completed.
90026	The requested instalment plan is invalid.

status integer

error string

error_code integer

401 Missing or invalid API key

Estimate transaction costs

Validate coupon codes

/transactions/finalise/{uuid}

1 const response = await fetch("https://api.tamio.com/v2/transactions/finalise/{uuid}", {
2   method: "POST",
3   headers: {
4     "Authorization": "Bearer YOUR_API_KEY",
5     "Content-Type": "application/json"
6   },
7   body: JSON.stringify({
8     "plan": "string",
9     "redirect": "string",
10     "payment": "string",
11     "shipping": "00000000-0000-0000-0000-000000000000"
12   })
13 });
14 const data = await response.json();

1 require "uri"
2 require "net/http"
3 require "json"
4 
5 url = URI("https://api.tamio.com/v2/transactions/finalise/{uuid}")
6 
7 https = Net::HTTP.new(url.host, url.port)
8 https.use_ssl = true
9 
10 request = Net::HTTP::Post.new(url)
11 request["Accept"] = "application/json"
12 request["Authorization"] = "Bearer YOUR_API_KEY"
13 request["Content-Type"] = "application/json"
14 request.body = {
15   plan: "string",
16   redirect: "string",
17   payment: "string",
18   shipping: "00000000-0000-0000-0000-000000000000"
19 }.to_json
20 
21 response = https.request(request)
22 puts response.read_body

Responses

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

1	const response = await fetch("https://api.tamio.com/v2/transactions/finalise/{uuid}", {
2	method: "POST",
3	headers: {
4	"Authorization": "Bearer YOUR_API_KEY",
5	"Content-Type": "application/json"
6	},
7	body: JSON.stringify({
8	"plan": "string",
9	"redirect": "string",
10	"payment": "string",
11	"shipping": "00000000-0000-0000-0000-000000000000"
12	})
13	});
14	const data = await response.json();

1	require "uri"
2	require "net/http"
3	require "json"
4
5	url = URI("https://api.tamio.com/v2/transactions/finalise/{uuid}")
6
7	https = Net::HTTP.new(url.host, url.port)
8	https.use_ssl = true
9
10	request = Net::HTTP::Post.new(url)
11	request["Accept"] = "application/json"
12	request["Authorization"] = "Bearer YOUR_API_KEY"
13	request["Content-Type"] = "application/json"
14	request.body = {
15	plan: "string",
16	redirect: "string",
17	payment: "string",
18	shipping: "00000000-0000-0000-0000-000000000000"
19	}.to_json
20
21	response = https.request(request)
22	puts response.read_body