API Documentation
Explore the documentation and get started with Skinify
Skins Withdraw Buy and withdraw a skin
This method allows you to purchase a skin and send it to a Steam user.
HTTP Request
POST https://skinify.io/api/withdraw/buy
POST Parameters
Parameter
Required
Description
partner
'partner' parameter from user Trade URL
token
'token' parameter from user Trade URL
name + game
— Or —
id
Skin name + game (dota2, csgo, rust, tf2)
— Or —
Skin ID from search results
max_price
The maximum price of the skin to purchase (in USD). Used as a cost limiter.
custom_id
ID on your system. It can be used to prevent double purchases.
Response
The response will contain the following data:
Parameter
Description
skin
Object containing data about the purchased skin
purchase_id
Purchase ID, used later to track the status of the purchase
purchase_status
Purchase status. This method can only contain purchase_status=processing, but the following statuses are possible in other methods:
- processing — trade is being processed
- waiting_accept — waiting for the user to accept trade
- accepted — trade was accepted by the user
- canceled — trade was rejected by the user
- timeout — waiting time for accepting trade has ended (5 minutes)
- error_invalid_token — invalid 'token' parameter was passed
- error_user_not_tradable — user has restrictions on accepting trades
- error_create_failed — failed to create trade (try again)
date
Purchase date (unix timestamp)
balance_debited_amount
The amount debited from the balance
custom_id
The custom_id you passed
Response example
{
"status": "success",
"skin": {
"id": "11552",
"name": "Crimson Pique",
"price": 0.3,
"properties": {
"classid":"1723113626"
}
},
"purchase_id": 1,
"purchase_status": "processing",
"date": "1643714026",
"balance_debited_amount": 0.3,
"custom_id": "1234"
}
Possible Errors
Error
Description
missing_skin_parameters
Required parameters are missing (name + game or id)
name_too_short
The minimum length of the skin name is 3 characters. Check the 'name' parameter and what data is passed to it
missing_partner_or_token
Missing 'token' or 'partner' paremeters
insufficient_funds
There are not enough funds on the project balance to purchase a skin
skin_unavailable
The skin is not available for purchase
skins_not_found_at_specified_price
There are no skins available, the cost of which is <= 'max_price'
custom_id_exists
A purchase has already been made with the specified custom_id
withdraw_unavailable
The withdraw is temporarily unavailable