Billing & hosting

Let clients pay WHMCS invoices with skins

Upload one module and every invoice gets a Pay with skins button. Payments are recorded on the invoice automatically, in the invoice currency.

skinsflow-whmcs.zip · 10 KB · Free

  • WHMCS 8+
  • PHP 7.4+
  • HTTPS

Game server hosts, VPS providers and bot hosting companies bill through WHMCS, and many of their clients are players first. When a renewal is due, some of them would rather trade a few skins than find a card. The SkinsFlow gateway module gives them that option on every invoice.

The client clicks Pay with skins on the invoice, picks CS2, Dota 2 or Rust items covering the balance due and accepts one Steam trade. SkinsFlow sends a signed notice, the module checks it, reads the payment again from SkinsFlow and records it on the invoice. WHMCS then does what it always does: marks the invoice paid, unsuspends the service, sends the receipt.

Your SkinsFlow balance is in USD. The payment is recorded in the invoice currency using your WHMCS rates, and the SkinsFlow fee of 2.5% is recorded as the transaction fee, so your books match what reached your balance.

Features

What you get with WHMCS

A button on every invoice

Clients pay the open balance of any invoice, including renewals and add-ons.

Recorded for you

Payments are added to the invoice automatically with the SkinsFlow payment ID as the transaction ID.

Your invoice currencies

Payments are created in the invoice currency when SkinsFlow supports it, or converted with Convert To For Processing.

Fees on the record

The SkinsFlow fee is stored as the transaction fee, so reports show exactly what was credited.

Trade Protection logged

Protected payments appear in the gateway log as pending and are recorded when they settle.

Test mode

Pay a test invoice with your test secret before clients see the button.

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) AK-47 | Redline Field-Tested $24.05
  • AWP | Asiimov (Field-Tested) AWP | Asiimov Field-Tested $99.27
  • Knife ★ Karambit | Marble Fade (Factory New) Karambit | Marble Fade Factory New $937.37
  • M4A1-S | Solitude (Factory New) M4A1-S | Solitude Factory New $9.54
  • Gloves ★ Sport Gloves | Vice (Field-Tested) Sport Gloves | Vice Field-Tested $353.46
  • Desert Eagle | Printstream (Field-Tested) Desert Eagle | Printstream Field-Tested $32.78
  • Knife ★ Butterfly Knife | Fade (Factory New) Butterfly Knife | Fade Factory New $1,927.73
  • USP-S | Printstream (Field-Tested) USP-S | Printstream Field-Tested $35.05
  • M4A4 | Falak (Battle-Scarred) M4A4 | Falak Battle-Scarred $13.74
  • Glock-18 | AXIA (Field-Tested) Glock-18 | AXIA Field-Tested $17.29
Install

Set up WHMCS

  1. Create a project

    In the SkinsFlow dashboard, add your billing site under Projects & API keys and keep the secrets safe.

  2. Upload the module

    Unzip skinsflow-whmcs.zip into your WHMCS root folder. It adds files under modules/gateways only.

  3. Activate the gateway

    In the WHMCS admin open Setup, Payments, Payment Gateways, All Payment Gateways and click SkinsFlow (pay with skins).

  4. Paste your keys

    Enter the Client ID, API secret and webhook signing secret, and set Convert To For Processing if your invoices use a currency SkinsFlow does not support.

  5. Connect the webhook

    In the SkinsFlow dashboard open your project, Settings, and set the Webhook URL to your WHMCS address followed by /modules/gateways/callback/skinsflow.php.

  6. Test, then go live

    Turn on test mode, pay a small invoice, check it is recorded, then switch test mode off.

FAQ

WHMCS and skins payments

What does the WHMCS module cost?

Nothing. The WHMCS module 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.

Can clients pay part of an invoice?

The payment is created for the open balance of the invoice. If the client sends items worth more than needed, the value shown at checkout is what is recorded.

Which currency is recorded on the invoice?

The invoice currency. When the payment currency matches, the amount is exact; otherwise it is converted with the rates in your WHMCS currency settings.

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: the gateway log shows it as pending and the invoice stays unpaid. 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.

What if Steam returns the items?

If you released a protected payment early and Steam later returns the items, the gateway log and activity log say so. Review the invoice and the service it paid for.

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. Gateway log entries show whether a payment was live.

Where are the logs?

In WHMCS under Billing, Gateway Log, filtered by SkinsFlow. Secrets are never written to the log.

Related integrations

Other ways to take skins

Pay button

Any website · A server that creates payments

One script tag: the checkout in a window over your page.

Setup guide One script tag

PHP SDK

PHP 8.0+ · ext-curl and ext-json

Create payments and check notices from any PHP site or framework.

Industries

Who uses it

Start today

WHMCS, now taking skins.

Open an account, add your site, install. Verification is free.

Get started