Getting Started

PWF Platform helps marketers, agencies and developers validate phone numbers, clean contact lists and integrate the same checks into their own apps. This guide walks you through every part of the platform.

There are three ways to use the platform:

• Web app — sign up, top up your balance and start running checks from the dashboard
• Telegram bot — place orders and check status without leaving Telegram
• User API — script common actions from your own code
• Reseller portal — for agencies that need a B2B account with custom pricing, an OAuth2 API and webhooks
• Shop — buy ready-made datasets of validated numbers and channel lists

Creating an Account

Registration takes under a minute. You only need a username and password — everything else is optional.

Placing an Order

Once you have balance, placing an order takes 4 quick steps:

Number Tools

Beyond filtering, PWF Platform ships a set of free or low-cost utilities for everyday number work:

All tools are accessible from the user dashboard and respect the same balance and credit system as orders.

Shop & Data Marketplace

The Shop section lets you buy ready-made data packs instead of running validation yourself:

• Pre-filtered lists of active numbers by country and platform
• Hash channels — bundles of group/channel hashes for outreach
• Carrier-specific datasets (e.g. WhatsApp-active numbers on a given network)
• Custom packs requested via support

Telegram Bot

The Telegram bot mirrors most of the web interface. Once you link your Telegram ID in your profile, you can use these commands:

• /start — open the main menu and link your account
• /balance — check your current balance
• /price <service> [qty] — see the price of a service for a given quantity
• /orders — list your recent orders and their status
• /help — show all available commands and tips

The bot also pushes notifications when orders complete, when your balance runs low and when a recharge is approved.

Becoming a Reseller

Reseller accounts are kept completely separate from regular user accounts: different sign-in URL, different balance, different pricing tiers, different documentation.

Who is it for?

• Agencies running marketing campaigns at scale
• SaaS platforms that need to embed number validation
• Bot and tool developers building on top of our checks
• Anyone processing more than 50,000 numbers per month

Reseller benefits

The Reseller Portal

Once approved, sign in at /reseller/login.php. The portal contains everything you need to manage your B2B account:

• Dashboard: Real-time balance, order volume, revenue and quick links to the most-used actions.
• Orders: Every order placed via the portal or the API, with status, result downloads and per-order details.
• Recharge: Top up your balance in EUR via the supported payment methods. Approved recharges are credited automatically.
• Transactions: Full ledger of every credit and debit — useful for billing reconciliation.
• API Keys: Generate and rotate OAuth2 client IDs and secrets. You can have multiple sets for different environments.
• Profile: Company details, contact info, password and webhook URLs.

Everything visible in the portal is also exposed through the API — pick whichever fits your workflow best.

API & SDK

The Reseller API is OAuth2-based with JWT bearer tokens. The base URL is /api/v1/ and all endpoints return JSON.

Authentication

Exchange your client credentials for an access token (valid for 1 hour) and a refresh token (valid for 30 days).

POST /api/v1/auth/token.php
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials
&client_id=rsl_xxxxxxxxxxxx
&client_secret=xxxxxxxxxxxxxxxx

Include the access token on every subsequent call as Authorization: Bearer <token>.

Core endpoints

• POST /api/v1/auth/token.php — obtain a JWT access token from client credentials
• GET /api/v1/account/balance.php — current balance and currency
• GET /api/v1/services/list.php — list every service available to your account with prices and limits
• POST /api/v1/services/<slug>.php — submit a new order for the given service slug
• GET /api/v1/orders/list.php — paginated list of your orders
• GET /api/v1/orders/status.php — poll a specific order's status
• GET /api/v1/orders/download.php — fetch a signed download URL for completed results

Official SDKs

We maintain SDKs for the most common languages so you don't have to handle token refresh and pagination yourself:

• PHP — composer require pwf/reseller-sdk
• Node.js — npm install @pwf/reseller-sdk
• Python — pip install pwf-reseller
• cURL examples — every endpoint also has a copy-paste cURL example in the docs

Rate limiting

The default limit is 60 requests per minute per account. Higher limits can be requested for production workloads.

Webhooks

Instead of polling order status, you can configure a webhook URL that receives a POST request whenever something happens. Set it in Reseller Portal → Profile → Webhooks.

Supported events

• order.completed — an order finished successfully and results are ready to download
• order.failed — an order failed (refund is automatic)
• order.refunded — an order was refunded (manually or automatically)
• balance.low — your balance fell below the configured threshold

Signature verification

Every webhook ships with two headers so you can prove the request came from us:

X-PWF-Signature: sha256=<hex_hmac>
X-PWF-Timestamp: 1716123456

Compute HMAC-SHA256(body, your_secret) and compare it to the X-PWF-Signature header. Reject any payload where the signature doesn't match or the timestamp is older than 5 minutes.

Custom Pricing & Recharge

Reseller pricing is layered. For every service we track four numbers:

• User price: what an end-user on the public site pays — your reference point
• Global default: what every reseller pays unless they have a specific override
• Per-reseller override: a custom price negotiated for your account that supersedes the global default
• Derived price: the fallback: user price × the default reseller markup

You can always see which tier is being applied on any service from your Reseller Portal — the Source column shows global default, override or derived.

Recharging your balance

From the Recharge page, pick an amount and a payment method. Once approved, your balance is credited and you receive a Telegram notification.

• Bank transfer (SEPA) — typically 1 business day
• Crypto (USDT, BTC) — credited automatically on chain confirmation
• Manual via support for special arrangements

Pricing & Credits

PWF Platform uses a simple prepaid credit model — no subscriptions, no surprises.

The credit system

• Pay only for what you use — no monthly fees
• Balance is stored in Euros (€) and never expires
• Top up any amount above the platform minimum
• Every transaction is logged in your Transactions history

Service pricing

Prices are set per service and are quoted per price unit — usually 10,000 numbers, but some services use 1,000 or even 1.

• Each service has its own price visible on the New Order page
• Pricing units vary — always check the unit shown next to the price
• Partial quantities are billed proportionally
• Formula: cost = (numbers ÷ price_unit) × price_per_unit

Accepted payment methods

You can top up using:

• Bank transfer (SEPA, IBAN)
• Cryptocurrency (USDT TRC20/ERC20, BTC)
• Manual top-up via Telegram support for special cases

Promo Codes

Promo codes give you a percentage discount on an order. Enter the code on the order page before confirming.

• Each code can be limited to a specific service, minimum order value or max discount cap
• Codes can have a total usage limit, a per-user limit, and an expiry date
• Codes apply only to the order they're entered on — not retroactively
• Discounts come off the displayed price before tax

Security & 2FA

PWF Platform protects your account with industry-standard safeguards: HTTPS/TLS everywhere, bcrypt password hashing with per-user salts, session management and CSRF protection on every form.

Two-factor authentication via Telegram

When 2FA is on, every login requires a one-time code sent to your Telegram. Enabling it takes 3 steps:

1. Open your profile and add your Telegram ID
2. Start a chat with our bot and click the verification link
3. Turn on the 2FA toggle in profile settings

Account safety tips

• Use a unique password you don't use anywhere else
• Enable 2FA — it stops 99% of account takeovers
• Never share your password or API client secret with anyone — we never ask for them
• Check your recent logins regularly and report anything unfamiliar

Refunds

PWF Platform takes a customer-first stance on refunds: if a check fails because of something on our side, you get your credits back automatically.

Automatic refunds

We automatically refund your balance when:

• An order fails due to a server-side error or upstream provider outage
• A submitted number is rejected before processing (e.g. invalid format)
• The result for a number cannot be determined within the service-level window

Manual refund requests

For anything else, contact support on Telegram within 7 days of the order with the order ID and a short description. The team reviews each request and credits eligible refunds back to your balance.

Support

You can reach the team through any of these channels:

Frequently Asked Questions