API'mizle Sanal Numara Bayiliği: Fiyatlar ve Marj

SMS Activate App API'siyle özel sanal numara bayiliği: hesabınızda fiyatımızla alın, marjınızı ekleyin, müşterilere botunuz veya sitenizden sunun.

Kendi müşterilerinize beyaz etiket (white-label) bir hizmet, bir Telegram botu veya küçük bir site üzerinden özel sanal numara sunmak istiyorsanız bu rehber sizin için. Rehber; kurulumun nasıl işlediğini, her numaranın nasıl fiyatlandırılacağını, ihtiyacınız olan API çağrılarını, faturalandırmanın nasıl yürüdüğünü ve sorumluluğumuzun nerede bittiğini anlatır.

Bayilik nasıl işler

SMS Activate App'te bir hesabınız ve bir API anahtarınız olur. Numaraları bu hesap üzerinden API ile satın alırsınız. Ardından botunuz veya siteniz her müşteriye kendi numarasını ve o numaraya gelen SMS doğrulama kodlarını gösterir.

Her numara, ülkeye göre bir operatörün numara aralığından gelen gerçek bir mobil veya yerel numaradır. Hesabınız numarayı 28 günlük bir süre boyunca elinde tutar. Numara SMS ve arama alır.

Müşterileriniz sizin müşterilerinizdir. Ödemelerini siz alırsınız, sorularını siz yanıtlarsınız, koşullarınızı siz belirlersiniz. Müşterilerinizin bizde hesap açması gerekmez. Bu model hakkında daha fazlası bayi sayfasında.

Fiyatınızı ve marjınızı belirleyin

Fiyatımız numara ve ülke bazında belirlenir. Fiyatı API'den canlı olarak okursunuz:

  • GET /v1/public/countries her ülke için minPriceCents, maxPriceCents ve availableNumbers değerlerini döndürür.
  • GET /v1/public/numbers/search?country=US&limit=20 satışta olan canlı numaraları döndürür. Her birinin priceCents alanı sizin fiyatınızdır.

API'deki tüm tutarlar tam sayı olarak ABD doları sentidir.

Sizin fiyatınız, o numara için bizim fiyatımız artı marjınızdır. Bir numaranın size maliyeti C ise ve onu P fiyatına satıyorsanız, marjınız P eksi C olur. Marj yüzdeniz (P eksi C) bölü P'dir. Kâr ekleme oranı (markup) farklı bir değerdir: (P eksi C) bölü C. Kâr ekleme oranı her zaman ikisinden büyük olanıdır. Bu yüzden bir hedef belirlemeden önce hangisini kastettiğinize karar verin.

Her satışta canlı fiyattan yeniden hesaplayın. Sabit bir listeyle çalışmayın, çünkü fiyatlar ülkeye göre değişebilir. Bayi indirimi veya hacim kademesi yoktur: fiyatlar sayfasında gösterilen normal fiyattan satın alırsınız.

Şu maliyetleri de bütçenize katın:

  • Kesin satın almalar. Bir numara verildiği anda kesinleşir ve iade edilmez, platform numarayı reddetse bile.
  • Platform kararları. Bir numarayı kabul edip etmeyeceğine biz değil, platform karar verir. Müşterilerinizin önce numaranın kendi hizmetinde çalışıp çalışmadığını kontrol etmesine izin verin ya da bu riski fiyatınıza yansıtın.
  • Otomatik yenileme. Otomatik yenilemeyi kapatmadığınız sürece numara her 28 günde bir yenilenir ve ücretlendirilir.
  • Ödeme komisyonları. Kendi ödeme sağlayıcınız her müşteri ödemesi için sizden ücret alır.
  • Destek süresi. Müşterileriniz size soru soracak ve bunları yanıtlamak zamanınızı alacak.

Adım adım API akışı

Temel URL: https://api.sms-activate.app/v1/public. Katalog dahil her çağrı, Authorization: Bearer vpn_xxx başlığında anahtarınızı gerektirir.

  • Ülkeleri listeleyin. Hangi ülkelerde numara olduğunu ve fiyat aralıklarını görmek için GET /countries çağrısını yapın.
  • Numara bulun. Bir ülkenin canlı numaralarını listelemek için GET /numbers/search?country=US&limit=20 çağrısını yapın. Her numaranın priceCents alanında sizin fiyatınız yer alır.
  • Numara satın alın. POST /numbers çağrısını {"phone": "+15551234567", "country": "US"} JSON gövdesiyle ve bir UUID'ye ayarlanmış Idempotency-Key başlığıyla yapın. Yeniden denemede aynı anahtarı gönderirseniz sizden iki kez ücret alınmaz. Başarılı bir satın alma, numarayla birlikte chargedCents ve balanceAfterCents değerlerini içeren 201 yanıtı döndürür. İki alan isteğe bağlıdır: autoRenew (varsayılan değer true) ve note. Müşterinizin referansını saklamak için note alanını kullanın.
  • Kodları okuyun. Tek bir numara için GET /numbers/{id}/sms, tüm numaralarınız için GET /sms çağrısını yapın. İkisi de imleç (cursor) tabanlı sayfalama kullanır. Kodların size kendiliğinden gelmesini istiyorsanız {"forwardWebhookUrl": "https://your-app.example.com/sms"} gövdesiyle PATCH /numbers/{id} çağrısını yapın: bundan sonra o numaraya gelen her SMS ve her arama, HMAC-SHA256 ile imzalanarak sunucunuza gönderilir. Her kodu göstermeden önce doğru müşteriyle eşleştirin.
  • Süreyi yönetin. Bir müşteri yenilemezse {"autoRenew": false} gövdesiyle PATCH /numbers/{id} çağrısını yapın. Artık ihtiyacınız olmayan bir numarayı bırakmak için DELETE /numbers/{id} çağrısını yapın.

Muhasebe için iki çağrı daha işinize yarar. GET /balance bakiyenizi sent cinsinden döndürür. GET /v1/me/transactions hesap ekstrenizi listeler.

Hatalar tek bir biçimde gelir: {"error": "<code>", "message": "...", "reqId": "..."}. Mantığınızı HTTP durum koduna göre değil, error koduna göre kurun. insufficientbalance, nonumbers ve priceexceeded gibi bazı retler birer yanıttır. İsteği körü körüne tekrarlamak yerine bunları müşterinize gösterin. ratelimited yanıtında Retry-After başlığının belirttiği süre kadar bekleyin.

Tam şartname OpenAPI dosyasında yer alır. API belgeleri her çağrıyı açıklar.

Faturalandırma: bizdeki bakiyeniz

Satın almalarınız hesap bakiyenizden ödenir. Web sitesinde bakiyenizi kripto parayla (USDT) yüklersiniz. Telegram botu ayrıca ruble banka kartı ve Telegram Stars kabul eder. Hesabınızı bağladığınızda ikisi aynı bakiyeyi kullanır.

Yoğun saatlerinizden önce yeterli bakiye bulundurun. Bakiye yetersizse satın alma insufficient_balance hatasıyla reddedilir ve siz bakiye yüklerken müşteriniz bekler.

Para çekme işlemleri yalnızca USDT (TRON, BSC veya TON) ile ödenir. Çekimi sitedeki hesabınızda veya Telegram botunda kendiniz yaparsınız: günde 100 dolara kadar olan çekimler birkaç dakika içinde otomatik ödenir, daha yüksek tutarı ise destek talep üzerine elle öder. Kartla ödenen, bonus olarak verilen veya aktarımla gelen para, geldikten 180 gün sonra çekilebilir; kripto yüklemeleri hemen çekilir. Alt sınır 10 dolardır. Ücret tutarın %10'udur, ancak 5 USDT'den az olamaz ve tutardan düşülür.

Kendi satın alımlarınız ve ortaklık programı

Kendi hesabınızda veya kontrol ettiğiniz herhangi bir hesapta yaptığınız satın alımlar hiçbir zaman ortaklık komisyonu kazandırmaz.

Bazı müşterileriniz kendi hesaplarını kullanmayı tercih eder. Onlara ortaklık bağlantınızı gönderin. Böylece onların satın alımları ve yenilemeleri üzerinden, hesapları var olduğu sürece kâr marjımızdan (fiyattan değil) %10 ile %30 arası bir pay kazanırsınız; pay, getirdiğiniz kişilerden satın alanlar arttıkça ilk 3 alıcı için %10'dan 3001. alıcıdan başlayarak %30'a yükselir. Her komisyon, satın alımdan 30 gün sonra bakiyenize eklenir. Ayrıntılar ortaklık programı ve bayi sayfalarında.

Destek

Müşterileriniz size ulaşır. Siz de bize ulaşırsınız. support@sms-activate.app adresine e-posta gönderdiğinizde veya Telegram'da t.me/BestVoipTelegram üzerinden yazdığınızda size bir kişi yanıt verir, genellikle 24 saat içinde.

Müşterilerinize, bizim size verdiğimizden fazla söz vermeyin. Her kodun geleceğine söz vermiyoruz. Bir platformun numarayı kabul edeceğine de söz vermiyoruz. Çoğu kod, platform gönderdikten sonra birkaç dakika içinde gelir. Müşterilerinize, bir numaraya güvenmeden önce onu kendi hizmetleri için test etmelerini söyleyin.

Faydalı videolar

Fiyatlandırma, Telegram botları ve API tasarımı üzerine üçüncü taraf videoları. Genel teknikleri anlatırlar, hizmetimizi kapsamazlar.

Başlayın