Platfone Docs

White-Label Widget

Monetize your website effortlessly by offering temporary phone numbers for SMS verifications.

The White Label Widget is an embeddable JavaScript/HTML component that lets your users buy temporary phone numbers directly on your website—and lets you earn from each SMS-verified activation. It is no code solution that integrates seamlessly to your website.

🧩 What Is It?

The White Label Widget is like embedding a YouTube video—but instead of playing a clip, it allows visitors to purchase a temporary phone number and receive SMS verifications.

  • No upfront costs or fees
  • Works on any website—just copy/paste a small code snippet
  • No backend or API integration required
  • Fully customizable with your colors and branding
  • Branded under your own domain

👉 Perfect for blogs, forums, tools, and any website that attracts users needing SMS verification.

💸 How You Earn

Every time a user receives an SMS through the widget on your site, you earn 75% of the profit from that activation.

  • Earnings tracked via your dashboard
  • Payouts processed monthly (or on request)
  • Supported payment methods for payouts: PayPal, crypto (fees may apply)

💡 Example: If an activation costs $3 and the profit is $2, you earn $1.50.

⚙️ How It Works (User Flow)

  1. User lands on your site and sees the widget.
  2. They choose a service (e.g. WhatsApp) and country.
  3. Widget shows pricing → user clicks Order.
  4. User is redirected to Temp-Number.org to complete the payment.
  5. After payment, the user returns to your site automatically.
  6. Widget shows the temporary number + SMS inbox.
  7. You earn when an SMS is received.

✨ Bonus: No need to handle payments, support, or SMS delivery—it’s all managed for you.

🚀 How to Set It Up

Getting started takes under 5 minutes.

  1. Create a Platfone Account

    Sign up here: https://platfone.com

  2. Customize Your Widget

    From your dashboard go to the Monetization -> White Label Widget:

    • Set your website domain (where the widget will be embedded)
    • Pick colors to match your brand
    • Set link to your logo
    • Set your brand name

  3. Embed the Code Copy the HTML/JavaScript snippet provided and paste it into any page on your website. Example:

    <!-- Widget containers -->
<div id="tn-app"></div>

<!-- Widget loader script with customization options -->
<script
  src="https://tn.platfone.com/tn.js"
  id="tn-script"
  data-name="Your Brand"
  data-logo="https://example.com/logo.png"
  data-background-color="#ffffff"
  data-text-color="#14142b"
  data-button-color="#fa8231">
</script>

  4. Go Live Users will instantly be able to start activating numbers and receiving SMS.

Widget Customization

You can customize the widget’s appearance using the following data- attributes in the <script> tag:

  • data-name: Your brand name (displayed in the widget header)

  • data-logo: URL to your logo image (displayed in the widget header)

    Use Full URL

    Make sure to use the full URL (including https://) for the logo image.

  • data-background-color: Background color of the widget (hex code)

  • data-text-color: Text color used in the widget (hex code)

  • data-button-color: Color of buttons in the widget (hex code)

  • data-locale: (Optional) Language locale for the widget (e.g. “en”, “es”). Defaults to “en”. If defined, in menu language selector will not be shown. Use this to control the language of the widget, if you already have a language selector on your site.

Widget Events

The widget dispatches CustomEvents to notify your application about user interactions and state changes.

Available Events:

  • tn:widgetLoaded - Widget has finished loading
  • tn:serviceSelected - User selected a service (detail: service)
  • tn:countrySelected - User selected a country (detail: country)
  • tn:startOrder - User initiated an order (detail: service, country)
  • tn:orderFailed - Order failed (detail: service, country, reason)
  • tn:numberReceived - Number successfully received (detail: service, country)
  • tn:numberCancelled - Number was cancelled (detail: service, country)
  • tn:reportSent - Report was sent
  • tn:addFundsStarted - User started adding funds
  • tn:balanceAdded - Balance was added

Listening to Events:

// Option 1: Listen on the widget host element (recommended)
const host = document.getElementById('tn-app')

host.addEventListener('tn:widgetLoaded', () => {
  console.log('✅ Widget is ready!')
})

host.addEventListener('tn:numberReceived', (event) => {
  const { service, country } = event.detail
  console.log(`📱 Number received for ${service} in ${country}`)
  // Track in your analytics
  // gtag('event', 'number_received', { service, country })
})
// Option 2: Listen on window (with guard to prevent duplicate events)
window.addEventListener('tn:numberReceived', (event) => {
  if (event.target !== window) return // Guard against duplicate events

  const { service, country } = event.detail
  console.log(`📱 Number received for ${service} in ${country}`)
})

💡 Tip: Events bubble up from the widget’s shadow DOM to the host element, so listening on #tn-app is the most reliable approach.

Live Widget Demo

Try the widget live on this demo page: https://platfone.com/widget.html

🏦 How Payouts Work

  • Tracking: Log in anytime to see detailed stats—activations, SMS received, earnings.
  • Payouts: Withdraw earnings monthly or upon request (minimum threshold may apply).
  • Processing time: Most requests are handled within 2 business days.

💼 Manage everything from your partner dashboard.

🤝 Start Earning Today

If you run a high-traffic site, blog, or online tool, this is a low-effort, high-reward monetization stream.

👉 Get Started Now – It’s free to join, and you can be live in minutes.