Samoa OTP API: Pasifik'te +685 Kayıt Akışlarını Test Etmek

Ürün ve QA ekipleri için kısaca Samoa

Samoa, resmî dilleri Samoaca ve İngilizce olan bağımsız bir Pasifik ülkesidir. Yeni Zelanda, Avustralya ve Amerika Birleşik Devletleri'nde büyük bir Samoalı topluluk yaşar; bu yüzden havale, mesajlaşma ve seyahat uygulamalarının, ülkeler arasında gidip gelen kullanıcılar için de sorunsuz çalışması gerekir.

Bilinmesi gereken iki ayrıntı var. Birincisi, Samoa (+685) ile Kuzey Amerika numaralandırma planı içinde yer alan ve +1 684 kullanan Amerikan Samoası farklı ülkelerdir; ülke seçicide ikisini karıştırmak kodların yanlış yere gitmesine yol açar. İkincisi, Samoa 2011'de Uluslararası Tarih Değişim Çizgisi'nin batı tarafına geçti ve saati UTC'nin çok ilerisinde işliyor; bu da süre dolumu mantığındaki tarih sınırlarını denemek için kullanışlı bir örnek oluşturur.

Bir ürün ekibi için Samoa nadiren tek başına bir lansman pazarıdır. Genellikle bir Pasifik açılımının parçası olarak, diaspora odaklı bir uygulamanın gereksinimi olarak ya da Apia'daki bir iş ortağı kuruluşun işletme hesabını doğrulaması gerektiği için gündeme gelir. Her durumda iş aynıdır: +685 numaralı bir kullanıcının kayıt akışınızı tamamlayabildiğini kanıtlamak.

+685 numarası kodda nasıl işlenmeli?

Samoa'nın ulusal numaraları çoğu pazara göre kısadır; dolayısıyla dokuz veya on haneli numaralara göre ayarlanmış doğrulayıcılar gerçek bir numarayı reddedebilir. Numaraları +685 ve ardından ulusal haneler olacak şekilde, ayraç kullanmadan kaydedin ve kullanıcının alışkanlıkla eklediği sıfırı silin. Webhook zaman damgaları Unix saniyesi olduğundan, sunucunuz ile Samoa'daki bir test uzmanı farklı takvim günlerinde olsa bile sürpriz yaşamamak için bunları yerel saate göre değil UTC'ye göre karşılaştırın.

Ürününüz aynı profilde Yeni Zelanda ve Samoa numaraları arasında geçişe izin veriyorsa, ülke kodunu değiştirip eski doğrulama durumunun temizlendiğini onaylayan bir test ekleyin; böylece bir numaraya gönderilen kod diğeri için asla kabul edilmez.

Samoa hatlarında hangi servisler kullanılabilir?

Samoa kataloğunda şu anda 600'den fazla servis listeleniyor. En sık istenenler arasında WhatsApp, Facebook, Instagram, Telegram, Google (Gmail & YouTube), Viber, Signal, TikTok, Microsoft & Outlook, Amazon ve Discord yer alıyor. Kapsam burada büyük pazarlara göre daha dar ve gün içinde değişiyor; bu yüzden her çalıştırmadan önce GET /api/v1/services ve GET /api/v1/countries çağrılarını kontrol edin. Bir servis yoksa, testiniz için Fiji veya Tonga gibi komşu bir hat uygun olabilir.

Daha hafif katalog, test altyapınızı toleranslı kurmak için iyi bir nedendir: tercih ettiğiniz servis çalışma anında yoksa vakayı başarısız saymak yerine atlandı olarak işaretleyin ve birinin sonra tekrar deneyebilmesi için kaydedin.

API ile Samoa kodu istemek

https://otproute.com/api/v1 adresine Bearer anahtarıyla (or_live_…) bağlanın; fiyatı GET /api/v1/prices?country=ws&service=<id> ile öğrenin, ardından POST /api/v1/activations uç noktasına {"service": "<id>", "country": "ws"} gönderin. Aktivasyon kimliğini GET /api/v1/activations/{id} ile yoklayarak ya da activation.sms_received olayını dinleyerek takip edin. Her webhook'ta X-OTPRoute-Signature HMAC imzasını doğrulayın, eski zaman damgalarını reddedin ve işleyiciyi aynı aktivasyon için iki kez çalışsa da zarar vermeyecek şekilde yazın. Entegrasyon rehberi tüm akışı gösterir.

Hız sınırları bu büyüklükteki bir pazar için cömerttir: her hesapta en fazla 10 anahtar, 5 webhook uç noktası ve dakikada 300 istek bulunur. Yoklama yapıyorsanız kontroller arasında birkaç saniye bırakmak yeterlidir.

Panelden elle yapmak

1. Giriş yapın ve OTP Gateway'i açın.
2. Servisi, ardından Samoa'yı seçin.
3. Güncel fiyatı kontrol edip onaylayın.
4. +685 numarasını test ettiğiniz uygulamaya yapıştırın ve kodu isteyin.
5. Kodu ekranda okuyun; artık gerekmiyorsa iptal edin.

+685 kodu geç geliyor veya hiç gelmiyorsa

Vazgeçmeden önce aktivasyonu tam 20 dakika açık tutun. Bazı uygulamalar sanal numaraları tamamen reddeder; yanıtsız kalan siparişlerin iade edilmesinin nedeni tam olarak budur. Bir hat sessiz kalırsa daha sonra yeniden deneyin ya da başka bir servis hattı seçin; art arda yeni sipariş vermek nadiren işe yarar ve hız sınırınızı tüketir.

Her denemede aktivasyon kimliğini kaydedin; böylece sessizliğin belirli bir uygulamadan mı yoksa hattın bütününden mi kaynaklandığını görebilirsiniz.

Uzun süreli numaralar ve kullanım ödemesi

OTP Route, self-servis uzun süreli bir Samoa numarası satmaz. Dedicated Number'lar ayda $1.95'ten başlar ve yalnızca Amerika Birleşik Devletleri ile Kanada için geçerlidir; Samoa hattı için [email protected] adresine yazın, ancak ayarlanabileceğine dair bir söz yoktur. Ön ödemeli USD cüzdan kartları ve USDT/USDC'yi kabul eder, her yüklemede PDF fatura gönderir ve aylık ücret içermez. Parasını harcamadan ws akışını denemek için geliştirme hesabınızda sandbox modunu isteyin.

Sık sorulan sorular

Telefon numaralarında Samoa ile Amerikan Samoası aynı mı?

Hayır. Samoa +685, Amerikan Samoası ise +1 684 kullanır. Ülke seçicinizde ve API'de doğru olanı seçin.

Samoa için API ülke kimliği nedir?

Fiyat sorgusunda ve aktivasyon isteğinde ws kullanın.

Samoa doğrulama kodu ne kadar?

Kod başına $0.20'den başlar; kesin fiyat servise göre değişir ve siparişten önce gösterilir.

Yeni Zelanda veya Avustralya'dan bir Samoalı kullanıcının kaydını test edebilir miyim?

Evet. +685 numarası SMS'i alır ve OTP Route ekibiniz nerede çalışırsa çalışsın size gösterir.

Mesaj gelmezse ödeme yapar mıyım?

Hayır. Süresi dolan veya iptal edilen aktivasyonların ücreti cüzdana otomatik olarak iade edilir.

Samoa kodları hangi dillerde gelir?

Genellikle Samoaca ile birlikte resmî dil olan İngilizce. Çevresindeki metne değil, rakamlara göre ayrıştırın.

Bu numaralarla çok sayıda hesap açabilir miyim?

Hayır. Her servisin şartlarına uyun; Kabul Edilebilir Kullanım Politikası, OTP Route'u yalnızca kendi meşru hesaplarınızı ve ürünlerinizi test etmek ve işletmekle sınırlar.

Hizmet adları ilgili sahiplerinin ticari markalarıdır. OTP Route bunlarla bağlantılı değildir. Numaraları yasalara uygun kullanın; her hizmetin şartlarına ve Kabul Edilebilir Kullanım Politikamıza uyun.