Node.js SDK
Node.js 18+ · TypeScript optionalNo dependencies, TypeScript types, ESM and CommonJS.
Developer kits
Accept skins payments with the Python SDK
A small Python library for SkinsFlow: create payments, verify notices and read your balance from any Python backend or bot.
- Python 3.9+
- No dependencies
- Works with any framework
Python runs plenty of gaming backends, Discord and Telegram bots and stats sites. The SkinsFlow Python SDK lets them take skins with a few calls instead of a hand-written API client.
Your code creates a payment and sends the customer to the checkout link. The customer picks CS2, Dota 2 or Rust items and accepts one Steam trade. SkinsFlow sends a signed notice, the SDK verifies it, and you confirm the payment before you deliver.
It is framework-agnostic: call it from a Django view, a FastAPI route, a Celery task or a bot command. Test mode uses the same code with your test secret.
Features
What you get with Python SDK
Any framework
Django, Flask, FastAPI, bots and scripts. The client has no framework ties.
Payments and purchases
Create payments, read their status and buy skins from the market.
Webhook verification
Check every notice with your webhook signing secret before acting on it.
Typed errors
Clear exceptions for bad requests, authentication and network problems.
Test mode ready
Swap the secret to run every flow without real items.
What customers pay with
Real items, priced live.
Items like these are what your customers trade. Each one is valued the moment their inventory loads.
On the market right now
Live prices, refreshed every few minutes
-
AK-47 | Redline Field-Tested $25.50
-
AWP | Asiimov Field-Tested $98.88
-
Knife
Karambit | Marble Fade Factory New $950.68
-
M4A1-S | Solitude Factory New $9.56
-
Gloves
Sport Gloves | Vice Field-Tested $361.41
-
Desert Eagle | Printstream Field-Tested $32.86
-
Knife
Butterfly Knife | Fade Factory New $1,927.48
-
USP-S | Printstream Field-Tested $35.28
-
M4A4 | Falak Battle-Scarred $13.74
-
Glock-18 | AXIA Field-Tested $17.29
Install
Set up Python SDK
Create a project
In the SkinsFlow dashboard, add your app under Projects & API keys and keep the secrets in environment variables.
Add the SDK
Unzip skinsflow-python-sdk.zip into your project, or install it into your virtual environment.
Create a payment
Create the client with your Client ID and secret, create a payment and redirect to its checkout link.
Handle the webhook
Verify each notice with your webhook signing secret, read the payment again and deliver once.
Set the webhook URL
In the SkinsFlow dashboard open your project, Settings, and enter your endpoint as the Webhook URL.
Test, then go live
Run the flow with your test secret, then swap in the live one.
FAQ
Python SDK and skins payments
What does the Python SDK cost?
Nothing. The Python SDK is free to download and use. SkinsFlow charges 2.5% of each payment credited to your balance, and nothing else: no setup fee, no monthly fee, no minimum volume. Failed, expired and returned payments cost nothing.
Is it async?
The client is a simple synchronous library. Call it from a worker or thread if your app is fully asynchronous.
Can I use it in a Telegram or Discord bot?
Yes. Create a payment when a user asks to pay, send the checkout link, and deliver when your webhook confirms the payment.
What happens with Steam Trade Protection?
Steam can hold traded items for up to 7 days and return them to the customer in that window. A protected payment is not counted as paid yet: your webhook receives a protected status and you wait before you deliver. When the hold ends the payment completes on its own, or you can release it early in your SkinsFlow dashboard if you trust the customer.
Where is the API reference?
In the developer docs. Every endpoint the SDK wraps is described there with examples.
Can I test before going live?
Yes. Turn on test mode and use your project's test secret. The checkout then shows real items with real prices but no item and no money moves, and buttons let you play every outcome: paid, protected, returned, declined. Same code, different secret.
Related integrations
Other ways to take skins
PHP SDK
PHP 8.0+ · ext-curl and ext-jsonCreate payments and check notices from any PHP site or framework.
Pay button
Any website · A server that creates paymentsOne script tag: the checkout in a window over your page.
Industries
Who uses it
Start today
Get started
Python SDK, now taking skins.
Open an account, add your site, install. Verification is free.