Ana sayfa › SMS API › Bayilik
Bayilik API'si

SMS Onay Bayisi Olun

Turonay'ın sanal numara altyapısını kendi markanız ve kendi marjınızla satın. SMS onay bayilik modelinde maliyetinizi getPrices söyler, satış fiyatını siz belirlersiniz. Kademeli indirim, imzalı webhook ve yalnızca kod gelen aktivasyon için ödeme ile riskinizi küçük tutarsınız.

195şu an listelenen servis
210şu an listelenen ülke
TRY · USD · RUBgörüntüleme para birimi

API sayfaları

Bayilik kimler için?

Tek bir API anahtarıyla çok sayıda müşterinizin aktivasyonunu yönetebilir, SMS onayı kendi arayüzünüz arkasında satabilirsiniz. Arayüz, fiyat ve müşteri iletişimi sizde kalır; Turonay tarafında yalnızca API anahtarınıza bağlı bakiye hareket eder. Bu yüzden küçük bir botla başlayıp müşteri sayınız büyüdükçe aynı entegrasyonu kullanmaya devam edebilirsiniz.

Telegram bot sahipleri

Botunuza “numara al” komutu ekleyin. Müşteri bakiyesini siz tutarsınız; her aktivasyon Turonay bakiyenizden düşer.

Panel ve web sitesi sahipleri

Kendi sitenizde SMS onay satın. handler_api uyumlu paneller çoğunlukla yalnızca taban adresi değişikliğiyle bağlanır.

Ajanslar ve yazılım evleri

Müşterileriniz için tek bir entegrasyon yazın; fiyatlandırma ve faturalama kendi tarafınızda kalsın.

QA ve test ekipleri

Kayıt ve doğrulama akışlarınızı gerçek SMS ile uçtan uca test edin; kod gelmeyen denemeler için ödemezsiniz.

Marj nasıl çalışır?

getPrices yanıtındaki cost, Turonay'a ödeyeceğiniz tutardır; hesabınızdaki kademe indirimi bu tutara zaten yansımıştır. Müşterinize hangi fiyatı koyacağınız size aittir; aradaki fark marjınızdır.

bash
curl "https://turonay.com/stubs/handler_api.php?api_key=YOUR_KEY&action=getPrices&service=wa&country=62"
{"62":{"wa":{"cost":12.50,"count":744716}}}
KalemÖrnek tutar
Maliyetiniz (getPrices → cost)12.50 TRY
Sizin satış fiyatınız18.00 TRY
Aktivasyon başına marj5.50 TRY

Rakamlar yalnızca örnektir. Gerçek fiyatlar servise ve ülkeye göre değişir ve her zaman getPrices ile canlı okunmalıdır.

Satış fiyatınızı sabit tutacaksanız, aktivasyon başına katlanacağınız en yüksek maliyeti maxPrice olarak gönderin. Fiyat bu sınırı aşarsa satın alma yapılmaz ve marjınız eksiye düşmez. Fiyatı müşterinize göstermeden önce getPrices ile kontrol etmek, satış fiyatınızı güncel maliyete göre ayarlamak için en sağlam yoldur.

bash
curl "https://turonay.com/stubs/handler_api.php?api_key=YOUR_KEY&action=getNumber&service=wa&country=62&maxPrice=12"
WRONG_MAX_PRICE:12.50

Kademeli indirim

Her hesap, bakiyeye yaptığı toplam yüklemeye göre bir üyelik kademesine yerleşir. Yükledikçe kademeniz yükselir ve her kademenin bir indirim oranı vardır. Eşikleri ve oranları Turonay belirler; giriş yaptıktan sonra Kademe sayfasında güncel kademe listesini ve bir sonraki kademeye ne kadar kaldığını görürsünüz.

  • İndirim API fiyatlarına otomatik uygulanır: getPrices indirimli maliyetinizi gösterir, getNumber aynı fiyatı rezerve eder.
  • Birden fazla kademeye uyuyorsanız en yüksek indirim geçerlidir.
  • İndirim, fiyatı belirli bir taban fiyatın altına indirmez.
  • Kesin oranlar zamanla değişebileceği için bu sayfada sabit bir yüzde verilmiyor; geçerli oranı kademe sayfanızdan görürsünüz.

Entegrasyon seçenekleri

handler_api uyumlu bağlantı

handler_api uyumlu protokol sayesinde mevcut bot ve paneller çoğunlukla taban adres ve anahtar değişikliğiyle bağlanır. Dil bazlı örnekler: Python, PHP, Node.js.

Webhook ile bildirim

Kodu müşterinize yoklama yapmadan iletmek için imzalı webhook kullanın; bildirim kod kaydedildiğinde kuyruğa alınır, genellikle 1–2 dakika içinde ulaşır. Gövde HMAC-SHA256 ile imzalıdır.

Panel için getActiveActivations

getActiveActivations açık aktivasyonlarınızı kodlarıyla birlikte verir. Sunucunuz yeniden başladığında kaldığınız yerden devam eder, kendi yönetim ekranınızı bununla besleyebilirsiniz.

Tüm metotlar için SMS API merkezi ve API dokümanı sayfalarına bakın.

Risk ve ücretlendirme korumaları

Bayilikte asıl risk, teslim edilmeyen aktivasyon için ödeme yapmak ve fiyat dalgalanmasında zarar etmektir. Sistem bu iki riski şu şekilde sınırlar:

  • Kod gelince ücret: numara alındığında tutar yalnızca rezerve edilir, kod geldiğinde tahsil edilir.
  • Serbest bırakma: kod gelmeden iptal ederseniz, sağlayıcı iptal ederse ya da süre dolarsa rezerve tutar bakiyenize döner.
  • Fiyat tavanı: maxPrice aşılırsa satın alma yapılmaz ve WRONG_MAX_PRICE:fiyat döner.
  • Fiyat teklifi: getPrices ile gördüğünüz fiyat kısa bir süre (yaklaşık iki dakika) korunur; bu sürede fiyat yükselse bile gördüğünüz fiyat tahsil edilir.
  • Kod geldikten sonra iptal yoktur: setStatus 8 bu durumda EARLY_CANCEL_DENIED döner. Müşteri iade politikanızı bu kurala göre yazın.
  • Yetersiz bakiye: bakiye fiyatı karşılamıyorsa NO_BALANCE döner ve satın alma yapılmaz.
  • İstek sınırı: dakikalık bir istek sınırı vardır (varsayılan: anahtar ve IP başına dakikada 60 istek). Sık sorgulama yerine webhook kullanın.

Nasıl başlarsınız?

1. Kayıt olun

Hesabınızı oluşturmak için kayıt sayfasına gidin.

2. Bakiye yükleyin

Ödeme sayfasından kart, kripto veya havale ile bakiye ekleyin. Toplam yükleme kademenizi belirler.

3. API anahtarınızı alın

Profilinizin API bölümünden anahtarınızı oluşturun.

4. Test edin

getBalance ve getPrices ile bağlantıyı doğrulayın, ilk numarayı alın. Ayrıntılar: API dokümanı.

5. Webhook ekleyip canlıya geçin

Webhook adresinizi tanımlayın, profilden test olayı gönderin ve satışa başlayın.

Bayilik hakkında sık sorulanlar

Bayi olmak için ayrı bir ücret ya da sözleşme var mı?

API erişimi için ayrı bir abonelik ya da ücret yoktur. API anahtarınızı profilinizden alırsınız ve yalnızca teslim edilen kodlar için ödersiniz.

Müşterilerime kendi fiyatımı koyabilir miyim?

Evet. getPrices size kendi maliyetinizi gösterir; müşterinize hangi fiyatla sattığınız tamamen size aittir. Marjınız satış fiyatı ile maliyet arasındaki farktır.

Kademe indirimi nasıl belirlenir?

Kademe, hesabınıza yaptığınız toplam bakiye yüklemesine göre belirlenir ve her kademenin bir indirim oranı vardır. Birden fazla kademeye uyuyorsanız en yükseği geçerlidir. İndirim getPrices ve getNumber fiyatlarına otomatik yansır; güncel oranları giriş yaptıktan sonra kademe sayfanızda görürsünüz.

Müşterim kod gelmeden vazgeçerse ne olur?

Kod gelmeden setStatus 8 ile iptal ederseniz rezerve edilen tutar bakiyenize geri döner ve hiçbir ücret alınmaz. Sağlayıcı iptal ederse ya da süre dolarsa da aynı şekilde serbest bırakılır.

Kod geldikten sonra müşteri iptal isterse?

Kod geldikten sonra iptal yapılamaz: setStatus 8 EARLY_CANCEL_DENIED döndürür ve hizmet teslim edildiği için ücret iade edilmez. Kendi iade politikanızı buna göre belirleyin.

Aynı anda kaç aktivasyon çalıştırabilirim?

Eşzamanlı aktivasyon sayısı bakiyenize ve dakikalık istek sınırına (varsayılan olarak anahtar ve IP başına dakikada 60 istek) bağlıdır. Çok sayıda eşzamanlı aktivasyon planlıyorsanız sık sorgulama yerine webhook kullanın.

Fiyat ve stok bilgisini nasıl canlı takip ederim?

getPrices servis ve ülke bazında güncel fiyatı ve stok adedini JSON olarak verir; getNumbersStatus bir ülkedeki servis stoklarını, getCountries ise numara alınabilen ülkeleri listeler.

Bayi olarak başlayın

API anahtarınızı alın, getPrices ile maliyetinizi görün, küçük bir test aktivasyonuyla akışı doğrulayın ve ilk satışınızı yapın. Takıldığınız her noktada destek talebi sistemiyle bize yazabilirsiniz.