API documentation

Explore the documentation and get started with Skinify

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 check ‘partner’ parameter from user Trade URL
token check ‘token’ parameter from user Trade URL
name + game
or
id
check 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:

1.processing — trade is being processed
2.waiting_accept — waiting for the user to accept trade
3.accepted — trade was accepted by the user
4.canceled — trade was rejected by the user
5.timeout — waiting time for accepting trade has ended (5 minutes)
6.error_invalid_token — invalid ‘token’ parameter was passed
7.error_user_not_tradable — user has restrictions on accepting trades
8.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