Virtuelle Nummern per API weiterverkaufen: Preise und Marge

Verkaufe private virtuelle Nummern per SMS Activate App API weiter: zu unserem Preis auf deinem Konto kaufen, Marge aufschlagen, per Bot oder Website liefern.

Dieser Leitfaden ist für dich, wenn du deinen eigenen Kunden private virtuelle Nummern anbieten willst: über einen White-Label-Dienst, einen Telegram-Bot oder eine kleine Website. Er erklärt, wie das Setup funktioniert, wie du jede Nummer bepreist, welche API-Aufrufe du brauchst, wie die Abrechnung läuft und wo unsere Verantwortung endet.

So funktioniert der Weiterverkauf

Du hast ein Konto bei SMS Activate App und einen API-Schlüssel. Über die API kaufst du Nummern auf diesem Konto. Dein Bot oder deine Website zeigt dann jedem Kunden seine Nummer und die SMS-Bestätigungscodes, die dort ankommen.

Jede Nummer ist je nach Land eine echte Mobil- oder Ortsnummer aus dem Nummernbereich eines Netzbetreibers. Dein Konto hält sie für eine Laufzeit von 28 Tagen. Sie empfängt SMS und Anrufe.

Deine Kunden sind deine Kunden. Du nimmst ihre Zahlungen entgegen, beantwortest ihre Fragen und legst deine eigenen Bedingungen fest. Sie brauchen kein Konto bei uns. Mehr zu diesem Modell findest du auf der Reseller-Seite.

Preis und Marge festlegen

Unser Preis gilt pro Nummer und pro Land. Du liest ihn live über die API aus:

  • GET /v1/public/countries liefert für jedes Land minPriceCents, maxPriceCents und availableNumbers.
  • GET /v1/public/numbers/search?country=US&limit=20 liefert die Nummern, die gerade zum Kauf stehen. Das Feld priceCents jeder Nummer ist dein Preis.

Alle Geldbeträge in der API sind ganzzahlige US-Cent.

Dein Preis ist unser Preis für diese Nummer plus deine Marge. Kostet dich eine Nummer C und verkaufst du sie für P, beträgt deine Marge P minus C. Deine Marge in Prozent ist (P minus C) geteilt durch P. Der Aufschlag ist eine andere Kennzahl: (P minus C) geteilt durch C. Der Aufschlag ist immer der größere der beiden Werte. Entscheide also, welchen du meinst, bevor du ein Ziel festlegst.

Rechne bei jedem Verkauf neu mit dem Live-Preis. Arbeite nicht mit einer festen Liste, denn die Preise können sich je nach Land ändern. Es gibt keinen Reseller-Rabatt und keine Mengenstaffel: Du kaufst zum normalen Preis, demselben, der unter Preise steht.

Plane auch diese Kosten ein:

  • Endgültige Käufe. Eine Nummer ist nach der Ausgabe endgültig und nicht erstattbar, auch wenn eine Plattform sie ablehnt.
  • Entscheidungen der Plattform. Die Plattform entscheidet, ob sie eine Nummer akzeptiert, nicht wir. Lass deine Kunden zuerst prüfen, ob eine Nummer für ihren Dienst funktioniert, oder rechne dieses Risiko in deinen Preis ein.
  • Automatische Verlängerung. Eine Nummer verlängert sich alle 28 Tage und wird abgerechnet, solange du die automatische Verlängerung nicht ausschaltest.
  • Zahlungsgebühren. Dein eigener Zahlungsdienstleister berechnet dir Gebühren für jede Zahlung deiner Kunden.
  • Zeit für Support. Deine Kunden werden dir Fragen stellen, und die Antworten kosten dich Zeit.

Der API-Ablauf Schritt für Schritt

Die Basis-URL ist https://api.sms-activate.app/v1/public. Jeder Aufruf, auch der Katalog, braucht deinen Schlüssel im Header Authorization: Bearer vpn_xxx.

  • Länder abrufen. Rufe GET /countries auf, um zu sehen, welche Länder Nummern haben und in welcher Preisspanne.
  • Nummern finden. Rufe GET /numbers/search?country=US&limit=20 auf, um verfügbare Nummern für ein Land aufzulisten, jede mit deinem Preis in priceCents.
  • Nummer kaufen. Rufe POST /numbers mit dem JSON-Body {"phone": "+15551234567", "country": "US"} und einem Idempotency-Key-Header mit einer UUID auf. Sendest du bei einer Wiederholung denselben Schlüssel, wirst du nicht doppelt belastet. Ein erfolgreicher Kauf liefert 201 mit der Nummer, chargedCents und balanceAfterCents. Zwei Felder sind optional: autoRenew (Standard true) und note. In note kannst du die Referenz deines Kunden speichern.
  • Codes lesen. Rufe GET /numbers/{id}/sms für eine Nummer auf oder GET /sms für alle deine Nummern. Beide sind per Cursor paginiert. Sollen die Codes von selbst zu dir kommen, rufe PATCH /numbers/{id} mit {"forwardWebhookUrl": "https://your-app.example.com/sms"} auf: Dann wird jede SMS und jeder Anruf auf dieser Nummer an deinen Server gesendet, signiert mit HMAC-SHA256. Ordne jeden Code dem richtigen Kunden zu, bevor du ihn anzeigst.
  • Laufzeit verwalten. Verlängert ein Kunde nicht, rufe PATCH /numbers/{id} mit {"autoRenew": false} auf. Um eine Nummer freizugeben, die du nicht mehr brauchst, rufe DELETE /numbers/{id} auf.

Zwei weitere Aufrufe helfen bei der Buchhaltung. GET /balance liefert dein Guthaben in Cent. GET /v1/me/transactions listet deinen Kontoauszug auf.

Fehler haben immer dieselbe Form: {"error": "<code>", "message": "...", "reqId": "..."}. Verzweige nach dem error-Code, nicht nach dem HTTP-Status. Manche Ablehnungen wie insufficientbalance, nonumbers und priceexceeded sind Antworten. Zeig sie deinem Kunden, statt blind neu zu versuchen. Bei ratelimited warte so lange, wie der Header Retry-After angibt.

Die vollständige Spezifikation ist die OpenAPI-Datei, und die API-Dokumentation erklärt jeden Aufruf.

Abrechnung: dein Guthaben bei uns

Deine Käufe bezahlst du von deinem Guthaben. Auf der Website lädst du es in Krypto (USDT) auf. Der Telegram-Bot akzeptiert zusätzlich eine Rubel-Bankkarte und Telegram Stars. Sobald du dein Konto verknüpfst, nutzen beide dasselbe Guthaben.

Halte vor deinen Stoßzeiten genug Guthaben bereit. Reicht dein Guthaben für einen Kauf nicht aus, wird er mit insufficient_balance abgelehnt. Dein Kunde wartet dann, während du auflädst.

Auszahlungen gibt es nur in USDT (TRON, BSC oder TON). Du zahlst selbst aus, in deinem Konto auf der Website oder im Telegram-Bot: Bis 100 $ pro Tag werden automatisch innerhalb weniger Minuten ausgezahlt, einen höheren Betrag zahlt der Support auf Anfrage von Hand aus. Geld aus Kartenzahlungen, Boni und erhaltenen Übertragungen kannst du erst 180 Tage nach dem Eingang auszahlen, Krypto-Aufladungen sofort. Das Minimum beträgt 10 $. Die Gebühr liegt bei 10 % des Betrags, mindestens aber bei 5 USDT, und wird vom Betrag abgezogen.

Eigene Käufe und das Partnerprogramm

Käufe über dein eigenes Konto oder über ein anderes Konto, das du kontrollierst, bringen nie Partnerprovision.

Manche Kunden möchten lieber ein eigenes Konto. Schick ihnen deinen Partnerlink. Du erhältst dann 10 bis 30 % unserer Marge (nicht des Preises) auf ihre Käufe und Verlängerungen, solange ihr Konto besteht; der Anteil steigt mit der Zahl der Menschen, die du gebracht hast und die gekauft haben, von 10 % für die ersten 3 Käufer bis 30 % ab Käufer 3001. Jede Provision wird deinem Guthaben 30 Tage nach dem Kauf gutgeschrieben. Details findest du auf den Seiten Partnerprogramm und Reseller.

Support

Deine Kunden wenden sich an dich. Du wendest dich an uns. Ein Mensch antwortet per E-Mail an support@sms-activate.app oder in Telegram unter t.me/BestVoipTelegram, meist innerhalb von 24 Stunden.

Versprich deinen Kunden nicht mehr, als wir dir versprechen. Wir versprechen nicht, dass jeder Code ankommt, und wir versprechen nicht, dass eine Plattform eine Nummer akzeptiert. Die meisten Codes kommen innerhalb weniger Minuten an, nachdem die Plattform sie gesendet hat. Sag deinen Kunden, dass sie eine Nummer für ihren Dienst testen sollen, bevor sie sich darauf verlassen.

Nützliche Videos

Videos von Dritten zu Preisgestaltung, Telegram-Bots und API-Design. Sie vermitteln allgemeine Techniken und behandeln unseren Dienst nicht.

Start

  • Erstelle ein kostenloses Konto auf der Registrierungsseite.
  • Erstelle im Konto-Dashboard auf dem Tab „API-Schlüssel“ einen API-Schlüssel.
  • Lies die API-Dokumentation und die OpenAPI-Datei.
  • Prüfe die aktuellen Preise unter Preise.
  • Kauf eine Nummer und teste deinen Ablauf vollständig von Anfang bis Ende, bevor du den Verkauf startest.