Create an affiliate payout

POST https://api.tamio.com/v2/affiliates/payouts/create/{uuid}

Creates a payout for an affiliate partner using the specified payment gateway. Returns the transaction ID, invoice ID, and a public key for transaction verification.

Path Parameters

uuid string*

UUID of the affiliate to create the payout for.

Body Parameters

payment string*

Payment gateway identifier to use for the payout (e.g., "stripe", "paypal").

Responses

200 Payout created successfully.

Payout created successfully.

status integer

transaction string

UUID of the created transaction.

invoice string

UUID of the associated invoice (null if none).

public_key string

Public key for transaction verification.

400 Validation or business logic error. Possible causes:

Validation or business logic error. Possible causes:

uuid is missing, not a string, or not a valid UUID
payment is missing, not a string, or not a supported payment gateway
Additional properties present

Error codes:

Code	Description
1002	Affiliate not found
10201	Affiliate balance is zero / insufficient funds
10213	Payment method not supported by affiliate or program
90052	Missing merchant billing information

status integer

error string

error_code integer

401 Missing or invalid Bearer token.

List blocked affiliates for a program

List affiliate payouts

/affiliates/payouts/create/{uuid}

1 const response = await fetch("https://api.tamio.com/v2/affiliates/payouts/create/{uuid}", {
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/affiliates/payouts/create/{uuid}")
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": "string",
  "invoice": "string",
  "public_key": "string"
}

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