Skip to main content
POST
/
purchases
/
create
Create Purchase
curl --request POST \
  --url https://api.streamskill.pro/v1/purchases/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "tarif": {
    "id": 1,
    "quantity": 1000,
    "duration": 24
  },
  "channel": "twitch",
  "interval": 10,
  "comment": "Test comment",
  "start": false
}'
{
  "id": 1,
  "price": 10,
  "currency": "usd",
  "created_at": 1640000000,
  "order_type": "twitch_viewers",
  "channel": "https://www.twitch.tv/twitch",
  "status": "active",
  "service": "twitch",
  "parent": false,
  "api": true,
  "chatbot": false,
  "tarif": 1
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Accept-Language
enum<string>
default:en

The language of the response

Available options:
en,
ru

Query Parameters

​
expand
enum<string>

The expand of the purchase (you can use multiple values separated by commas)

Available options:
tarif,
parent,
api,
chatbot
Example:

"tarif,parent"

Body

application/json
​
tarif
object
required
​
channel
string
required

The channel (or another slug for tarif, for example - video id, clip id, etc.)

Example:

"twitch"

​
interval
integer

The interval of the purchase (if tarif supports custom interval)

Required range: 1 <= x <= 86400
Example:

10

​
comment
string
default:""

The comment for the purchase

Example:

"Test comment"

​
start
boolean
default:false

Start the purchase after creation (Use only if tariff supports start)

Example:

false

Response

OK

​
id
integer

The ID of the purchase

Required range: x >= 1
Example:

1

​
price
number

The price of the purchase

Example:

10

​
currency
enum<string>
Available options:
usd,
rub
Example:

"usd"

​
created_at
integer

The timestamp of the purchase creation

Example:

1640000000

​
order_type
string

The type of the order

Example:

"twitch_viewers"

​
channel
string

The channel (or another slug for tarif, for example - video id, clip id, etc.)

Example:

"https://www.twitch.tv/twitch"

​
status
enum<string>

The status of the purchase

Available options:
created,
awaiting,
working,
stopped,
completed,
failed,
deleted,
refunded
Example:

"active"

​
service
enum<string>

The service of the purchase

Available options:
twitch,
trovo,
kick,
youtube
Example:

"twitch"

​
parent
boolean
default:false

The parent of the purchase

​
api
boolean

The API of the purchase

Example:

true

​
chatbot
boolean
default:false

The chatbot of the purchase

​
tarif
integer

The ID of the tarif

Required range: x >= 1
Example:

1

⌘I