Üyelik ve kayıt doğrulama
Yeni hesapta girilen telefon numarasının gerçekten kullanıcıya ait olduğunu, kayıt tamamlanmadan doğrulayın.
Üyelik, giriş, ödeme ve şifre sıfırlama adımlarındaki tek kullanımlık kodları WaMessage SMS API ile otomatik gönderin. 1 SMS boyunda ve Türkçe karakter içermeyen mesajlar sistem tarafından OTP kanalına yönlendirilir; maliyet ayrı bir OTP paketi değil, standart SMS bakiyenizdir.
Kodu kimseyle paylasmayin. 3 dakika gecerlidir. – FIRMA
/api/v1/otp uç noktasıyla gönderilir; mesaj 1 SMS uzunluğundaysa ve Türkçe karakter içermiyorsa OTP kanalına yönlendirilir, aksi hâlde standart SMS akışında iletilir. Her OTP gönderimi SMS bakiyenizden 1 kredi düşer; paketler 500 SMS 195 TL'den başlar.OTP, İngilizce one-time password ifadesinin kısaltmasıdır: yalnız bir kez ve kısa bir süre için geçerli olan şifre. OTP SMS ise bu şifrenin kullanıcının telefonuna SMS ile ulaştırılmasıdır. Kullanıcı kodu ekrana girer, sisteminiz kodu kendi kaydıyla karşılaştırır ve işlem onaylanır. Kodu yalnız o telefonun sahibi gördüğü için numara doğrulanmış, işlemi yapan kişi de büyük olasılıkla hesabın sahibi olur.
SMS, internet bağlantısı ya da uygulama kurulumu gerektirmediği için doğrulama adımında en geniş erişimi sağlayan kanaldır. Bu yüzden OTP SMS, kullanıcının hangi telefonu kullandığından bağımsız çalışması gereken akışlarda tercih edilir.
Yeni hesapta girilen telefon numarasının gerçekten kullanıcıya ait olduğunu, kayıt tamamlanmadan doğrulayın.
Şifreden sonra ikinci adım olarak SMS kodu isteyin; çalınan şifre tek başına hesabı açmaya yetmez.
Para transferi, sipariş onayı, adres değişikliği gibi geri alınması zor işlemlerden önce kod isteyin.
E-posta erişimi olmayan kullanıcıya hesabını telefon numarasıyla güvenle geri verin.
Kapıda teslim, servis ziyareti ya da randevu girişinde müşterinin verdiği kodla işlemi kapatın.
Bir kampanyanın aynı numarayla tekrar tekrar kullanılmasını telefon doğrulamasıyla sınırlayın.
OTP ile standart SMS arasındaki ayrımı geliştirici keyfi olarak etiketlemez; WaMessage mesajın yapısına bakarak kanalı kendisi belirler. Kural iki koşuldan oluşur.
Mesaj tek SMS boyunu aşmamalıdır. Standart karakter setinde bu 160 karakterdir; uzun açıklamalar, linkler ve imzalar mesajı ikinci SMS'e taşır.
ş, ğ, ı, ç, ö, ü gibi karakterler mesajı standart karakter setinin dışına çıkarır. OTP metninde "Doğrulama" yerine "Dogrulama" yazın.
Her gönderim hesabınıza tanımlı onaylı bir başlıkla yapılır. Başlıklarınızı API'deki /senders uç noktasıyla listeleyebilirsiniz.
Bu koşulları karşılamayan mesajlar kaybolmaz; standart SMS akışında iletilir. Yalnız OTP kanalının sağladığı ayrı yönlendirmeden yararlanmaz.
| Ölçüt | OTP SMS | Standart / toplu SMS |
|---|---|---|
| Amaç | Kimlik veya işlem doğrulama | Kampanya, duyuru, bilgilendirme |
| Tetikleyen | Kullanıcının o anki eylemi (giriş, kayıt, ödeme) | Operasyon ekibi ya da zamanlanmış gönderim |
| Alıcı sayısı | Tek numara | Liste, çoğu zaman yüzlerce numara |
| İçerik | Kısa kod, 1 SMS, Türkçe karaktersiz | Serbest metin, gerekirse çok parçalı |
| Uç nokta | /api/v1/otp | /api/v1/1toN, /api/v1/NtoN veya panel |
| İptal linki | Gerekmez; ticari ileti değildir | Ticari içerikte eklenir (add_cancel_link) |
İyi bir OTP mesajı kullanıcının kodu bir bakışta bulmasını sağlar ve kendini dolandırıcılığa karşı korumasına yardım eder. Aşağıdaki sıra, hem tek SMS boyunda kalmayı hem de OTP kanal kuralını karşılamayı kolaylaştırır.
Telefonların bildirim önizlemesi mesajın ilk satırını gösterir. "Dogrulama kodunuz: 482913" ile başlayan mesajda kullanıcı uygulamayı değiştirmeden kodu okuyabilir. Bazı telefonlar kodu klavyede otomatik önerir; bunun için de kodun mesajın başında ve sayılardan oluşması işe yarar.
"3 dakika gecerlidir" gibi kısa bir not, kullanıcının eski bir kodu denemesini önler ve destek talebini azaltır. Süreyi sisteminizde de aynı şekilde uygulayın; mesajda yazan ile kodun gerçek ömrü farklı olmamalı.
"Kodu kimseyle paylasmayin" cümlesi, telefonla arayıp kodu isteyen dolandırıcılara karşı en etkili tek satırdır. Müşteri temsilcilerinizin de hiçbir koşulda kod istemediğini kullanıcıya bu şekilde hatırlatmış olursunuz.
OTP mesajına indirim, link ya da tanıtım cümlesi eklemek mesajı uzatır, iki SMS'e böler ve içeriği ticari iletiye çevirebilir. Doğrulama mesajında yalnız kod, süre ve marka adı olsun; kampanya için toplu SMS ayrı kurgulanır.
Şablonu yazarken ş→s, ğ→g, ı→i, ç→c, ö→o, ü→u dönüşümünü yapın. Tek bir Türkçe karakter mesajın OTP kanalına girmesini engeller ve karakter sınırını daraltır.
Giris kodunuz: 482913. Kodu kimseyle paylasmayin. - FIRMA
FIRMA uyelik dogrulama kodunuz: 715204. 3 dakika gecerlidir.
1.250 TL odemenizi onaylamak icin kod: 309871. Siz yapmadiysaniz bizi arayin. - FIRMA
Sifre sifirlama kodunuz: 640218. Bu islemi siz baslatmadiysaniz yok sayin.
OTP gönderimleri standart SMS paketlerinizden düşer; doğrulama için ayrı bir abonelik, kurulum ücreti ya da API ücreti alınmaz. Her OTP mesajı 1 SMS kredisidir. Fiyatlar 4 Kasım 2026 itibarıyla geçerlidir, KDV ve ÖTV dahildir.
| Paket | SMS / OTP adedi | Fiyat | OTP başına yaklaşık | Tür |
|---|---|---|---|---|
| Micro | 500 | 195 TL | 0,390 TL | Standart |
| Mini | 1.000 | 359 TL | 0,359 TL | Standart |
| Midi | 2.500 | 609 TL | 0,244 TL | Standart |
| Eko | 5.000 | 1.049 TL | 0,210 TL | Standart |
| Süper | 10.000 | 1.649 TL | 0,165 TL | Standart |
| Pro | 25.000 | 3.999 TL | 0,160 TL | Standart |
| Süper Tanışma | 10.000 | 889 TL | 0,089 TL | Yeni üyede ilk alım |
| Kurumsal | 50.000+ | Teklif | — | Özel |
Aylık OTP ihtiyacı kabaca doğrulama gerektiren işlem sayısı × (1 + yeniden gönderim oranı) ile bulunur. Ayda 4.000 giriş doğrulaması yapan ve kullanıcılarının yaklaşık %10'u "kodu tekrar gönder"e basan bir uygulama 4.400 SMS harcar; bu hacim için 5.000 SMS'lik Eko paket (1.049 TL) yeterlidir. Kredilerin son kullanım tarihi olmadığı için ay sonunda kalan bakiye bir sonraki aya devreder.
Kampanya, duyuru ve OTP aynı bakiyeden düşer. Paket karşılaştırması ve yeni üyelere özel tanışma paketlerinin tamamı için SMS paketleri ve fiyatları sayfasına bakın.
SDK gerekmez; HTTP isteği atabilen her dil bağlanır. Uç noktaların tüm alanları ve kod örnekleri SMS API dokümantasyonunda.
WaMessage hesabı açın, panelden API anahtarınızı oluşturun ve gönderici başlığınızı onaylatın.
Kodu kendi sunucunuzda rastgele üretin, süresiyle birlikte saklayın. Kod üretimi ve doğrulaması sizin tarafınızdadır.
Mesajı /api/v1/otp uç noktasına tek numarayla gönderin. Yanıttaki id değerini kaydedin.
/api/v1/report/detail ile numara bazında iletim durumunu ve zamanını okuyun; kod gelmedi şikâyetinde kanıt elinizde olsun.
| Örnek istek · POST https://api.toplusms.app/api/v1/otp |
|---|
{"api_key": "YOUR_API_KEY", "sender": "FIRMA", "message_type": "normal", "message": "Dogrulama kodunuz: 482913", "phones": ["905551112233"]} |
OTP SMS'in güvenliği yalnız mesajın ulaşmasına değil, kodu üreten ve doğrulayan sistemin kurallarına da bağlıdır. Aşağıdaki ayarlar hem kötüye kullanımı hem de gereksiz SMS harcamasını azaltır.
6 haneli sayısal kod, kullanıcı için yazması kolay ve tahmin edilmesi zor bir dengedir. Geçerlilik süresini 2-5 dakika arasında tutun; kullanılan ya da süresi dolan kodu hemen geçersiz sayın.
Aynı kod için yanlış deneme sayısını (örneğin 5) sınırlayın. "Kodu tekrar gönder" düğmesini ilk gönderimden sonra 60 saniye kapalı tutun ve bir numaraya saatte gönderilebilecek kod sayısını sınırlayın. Bu sınırlar olmadan bir bot, kayıt formunuz üzerinden binlerce numaraya kod gönderterek bakiyenizi tüketebilir.
Kod isteyen formun önüne CAPTCHA ya da benzeri bir bot koruması koyun ve aynı IP adresinden gelen istekleri sınırlayın. OTP SMS gönderen her uç nokta, dışarıdan çağrılabilen bir SMS gönderme düğmesidir; korumasız bırakılmamalıdır.
Kullanıcı "kod gelmedi" dediğinde rapordan iletim durumuna bakmak, sorunun numarada mı, operatörde mi yoksa sizin akışınızda mı olduğunu hemen gösterir. Raporu kontrol etmeden aynı numaraya art arda kod göndermek hem maliyeti artırır hem de kullanıcıyı hangi kodun geçerli olduğu konusunda şaşırtır.
Kullanıcılarınızın büyük kısmı WhatsApp kullanıyorsa doğrulama kodunu WhatsApp Business API'nin kimlik doğrulama (authentication) şablonlarıyla da gönderebilirsiniz; SMS bu durumda yedek kanal olur. İki kanalın maliyet ve erişim farkı için WhatsApp mı SMS mi? karşılaştırmasına, WhatsApp tarafındaki mesaj ücretleri için WhatsApp Business API fiyatlandırması sayfasına bakın.
Ayda 50.000 üzeri doğrulama mesajı gönderiyorsanız ya da entegrasyon için teknik görüşme istiyorsanız formu doldurun; ekibimiz hacminize göre teklifle dönsün.
Müşteri temsilciniz en kısa sürede sizi arayacak.