पोलैंड (+48) वेरिफ़िकेशन कोड: चेकलिस्ट, API चरण और समाधान

शुरू करने से पहले: पोलिश साइन-अप टेस्ट करने के लिए मुझे क्या चाहिए?

यह सूची एक बार देख लें, तो पहला पोलिश ऑर्डर आम तौर पर बिना झंझट गुज़रता है:

1. क्रेडेंशियल। Developer console में Bearer key बनाएँ (वह or_live_ से शुरू होती है)। स्टेजिंग, CI और प्रोडक्शन के लिए अलग keys रोटेशन को आसान बनाती हैं।
2. पहचानकर्ता। पोलैंड pl है। सर्विस ids डिस्प्ले नामों को हार्ड-कोड करने की जगह GET /api/v1/services से लें।
3. फ़ंड। वॉलेट टॉप-अप करें; हर कीमत ऑर्डर से पहले दिखती है।
4. डिलीवरी का ठिकाना। एक HTTPS वेबहुक रजिस्टर करें और उसका secret सोर्स कंट्रोल से बाहर रखें। अगर इनबाउंड ट्रैफ़िक बंद है तो पोलिंग भी चलती है।
5. रेट बजट। API प्रति अकाउंट 300 रिक्वेस्ट प्रति मिनट की अनुमति देती है, इसलिए समानांतर सूट को उसी हिसाब से धीमा रखें।
6. दायरा। सिर्फ़ वही अकाउंट वेरिफ़ाई करें जो आपके अपने प्रोडक्ट, आपकी कंपनी या आपके क्लाइंट के हैं, और हर सर्विस की शर्तों के साथ हमारी Acceptable Use Policy का पालन करें।

पाइपलाइन के लिए ख़ास तौर पर CI पाइपलाइन में SMS OTP टेस्टिंग देखें।

फ़िलहाल कौन-सी सर्विसें +48 नंबरों पर कोड भेजती हैं?

OTP रूटिंग के लिए पोलैंड कैटलॉग की व्यापक प्रविष्टियों में से एक है, जो 2,300 से ज़्यादा सर्विसें कवर करता है। लोकप्रिय सर्विसों के मौजूदा स्नैपशॉट में Facebook, Instagram, TikTok, WhatsApp, Telegram, Viber, Signal, Snapchat, Discord, X (Twitter), LinkedIn, Google (Gmail & YouTube), Amazon, AliExpress, Uber और Netflix शामिल हैं।

इस सूची को वादा नहीं, शुरुआती बिंदु मानें। किसी भी रूट पर उपलब्धता दिन भर बदलती है, इसलिए हर ऑर्डर से पहले prices endpoint से उस ख़ास जोड़ी के बारे में पूछें।

पोलैंड OTP API के सटीक चरण क्या हैं?

https://otproute.com/api/v1 पर SMS वेरिफ़िकेशन API इस्तेमाल करते हुए एक ऑटोमेटेड टेस्ट ये करता है:

1. GET /api/v1/prices?country=pl&service=<id> पोलैंड में उस सर्विस की लाइव कीमत पक्की करता है।
2. POST /api/v1/activations को {"service": "<id>", "country": "pl"} के साथ भेजने पर +48 नंबर और एक activation id लौटता है।
3. आपका टेस्ट नंबर को साइन-अप फ़ॉर्म में टाइप करता है और SMS माँगता है।
4. हैंडलर को activation.sms_received मिलता है; अगर वह activation.expired या activation.cancelled देखे, तो रन को "डिलीवर नहीं हुआ" चिह्नित करता है।
5. वेबहुक के बिना, हर कुछ सेकंड में GET /api/v1/activations/{id} पढ़ें, जब तक कोड न आ जाए या विंडो ख़त्म न हो।
6. जब टेस्ट जल्दी ख़त्म हो, तब POST /api/v1/activations/{id}/cancel कॉल करें।

किसी भी payload पर भरोसा करने से पहले X-OTPRoute-Signature हेडर वेरिफ़ाई करें: उसमें t=<unix>,v1=<hex> होता है, जहाँ v1 endpoint secret से साइन किया गया <t>.<raw body> का HMAC-SHA256 है। पुराने टाइमस्टैम्प वाली किसी भी चीज़ को ठुकराएँ और हैंडलर को activation id पर idempotent बनाएँ। वेबहुक सुरक्षा गाइड जाँच को विस्तार से दिखाती है।

क्या मेरी ऑपरेशन्स टीम API के बिना पोलिश नंबर ऑर्डर कर सकती है?

हाँ। OTP Route डैशबोर्ड में OTP Gateway खोलें, पोलैंड चुनें, सर्विस खोजें और दिखी हुई कीमत की पुष्टि करें। ऑर्डर के बाद पोलैंड वेरिफ़िकेशन नंबर को ऐप की वेरिफ़िकेशन स्क्रीन में कॉपी करें और एक्टिवेशन कार्ड देखें; SMS मिलते ही उसका टेक्स्ट वहाँ दिखता है। कुछ इंस्टॉल करने की ज़रूरत नहीं, और वही वॉलेट ब्राउज़र और API दोनों को फ़ंड करता है।

पोलिश नंबर और मैसेज सँभालने में क्या अलग है?

पोलैंड में बंद नंबरिंग प्लान है और कोई ट्रंक प्रीफ़िक्स नहीं: हर नंबर, मोबाइल हो या फ़िक्स्ड, +48 के बाद नौ अंकों का होता है। इससे वैलिडेशन सुखद रूप से सख़्त हो जाता है। जो इनपुट नौ राष्ट्रीय अंकों तक न सिमटें उन्हें ठुकराएँ, तीन-तीन के समूह में यूज़र के जोड़े स्पेस और डैश हटाएँ, और +48 तथा नौ अंकों को एक E.164 स्ट्रिंग के रूप में सहेजें। भटका हुआ शुरुआती शून्य टाइपो है, सहेजने लायक प्रीफ़िक्स नहीं।

जब अकाउंट की भाषा पोलिश हो, तो वेरिफ़िकेशन मैसेज अक्सर पोलिश में आते हैं। ą, ę, ł और ż जैसे अक्षर GSM 7-बिट वर्णमाला से बाहर आते हैं, इसलिए अगर आप अपने पोलिश OTP टेक्स्ट ख़ुद भेजते हैं, तो छोटे सेगमेंट की उम्मीद रखें और टेम्पलेट को वैसे ही परखें जैसे वह हैंडसेट पर दिखता है। आने वाले कोड पार्स करते समय अंकों पर ध्यान दें और आसपास के शब्दों को अनदेखा करें।

यहाँ टेस्ट करने के आम कारण: पोलिश बाज़ार में उतरता प्रोडक्ट, पोलिश-भाषा फ़्लो की लोकलाइज़ेशन QA, मध्य यूरोप भर में बिज़नेस अकाउंट देखने वाली क्षेत्रीय टीमें, और ऐसे ऐप जिनके ग्राहकों में EU के दूसरे हिस्सों में रहने वाले पोलिश भाषी शामिल हैं।

समस्या-समाधान: +48 कोड क्यों नहीं आ रहा?

• विंडो अभी खुली है। कोई नतीजा निकालने से पहले उसे पूरे 20 मिनट दें; कोड आने पर ही आपसे चार्ज लगता है।
• सर्विस वर्चुअल नंबर ठुकरा सकती है। कुछ प्लेटफ़ॉर्म ऐसा करते हैं, और तब अपने आप होने वाला रिफ़ंड पूरी रकम वॉलेट में लौटा देता है।
• रूट व्यस्त है। बाद में दोबारा कोशिश करें, या कोई दूसरा सर्विस रूट टेस्ट करें।
• टेस्ट लूप में चल रहा है। हर कुछ सेकंड में फिर ऑर्डर करना आपका रिक्वेस्ट बजट जला देता है; बैकऑफ़ जोड़ें।

और पैटर्न फ़ेल हुई OTP डिलीवरी घटाने में एकत्र हैं।

क्या पोलैंड के लिए dedicated नंबर हैं, और भुगतान कैसे होता है?

सेल्फ़-सर्व प्रोडक्ट के रूप में नहीं। Dedicated Virtual Numbers, $1.95/month से, सिर्फ़ संयुक्त राज्य अमेरिका और कनाडा में मिलते हैं। लंबी अवधि वाली पोलिश लाइन के लिए [email protected] पर ईमेल करके पूछें; यह संभव है या नहीं, यह स्थानीय नियम तय करते हैं, इसलिए किसी चीज़ का वादा नहीं है।

भुगतान एक प्रीपेड USD वॉलेट में जाते हैं: कोई प्लान नहीं, कोई मासिक फ़ीस नहीं, कार्ड या USDT/USDC से टॉप-अप, और हर टॉप-अप का PDF इनवॉइस ईमेल से। डेवलपर्स इंटीग्रेशन बनाते समय सिम्युलेटेड नंबर और कोड पाने के लिए डेवलपमेंट अकाउंट पर सैंडबॉक्स मोड माँग सकते हैं। लाइव दरों के लिए प्राइसिंग देखें।

अक्सर पूछे जाने वाले प्रश्न

अगर टीम में किसी के पास +48 SIM नहीं है तो पोलिश साइन-अप फ़्लो कैसे टेस्ट करूँ?

OTP Gateway पर टेस्टिंग के लिए +48 नंबर ऑर्डर करें और उसे फ़्लो में इस्तेमाल करें। कोड डैशबोर्ड में दिखता है और आपके वेबहुक पर भेजा जा सकता है।

OTP Route API कॉल में पोलैंड का कंट्री कोड क्या है?

यह pl है, जो POST /api/v1/activations और कीमत वाली क्वेरी दोनों में इस्तेमाल होता है।

पोलिश फ़ोन नंबर में कितने अंक होते हैं?

+48 के बाद नौ राष्ट्रीय अंक, बिना ट्रंक शून्य के। यह तय लंबाई सर्वर-साइड वैलिडेशन को सीधा बना देती है।

पोलैंड SMS OTP पाने की लागत क्या है?

कीमतें $0.20 प्रति कोड से शुरू होती हैं और सर्विस के अनुसार बदलती हैं। डैशबोर्ड और prices endpoint ऑर्डर से पहले सटीक आँकड़ा दिखाते हैं।

अगर पोलिश एक्टिवेशन ख़ाली एक्सपायर हो जाए तो क्या मेरा पैसा डूबेगा?

नहीं। जो एक्टिवेशन बिना कोड के ख़त्म होता है, या जिसे आप कैंसल करते हैं, उसकी रकम पूरी तरह वॉलेट में लौटा दी जाती है।

क्या मैं लाइव जाने से पहले पूरे पोलैंड फ़्लो को सिम्युलेट कर सकता हूँ?

हाँ। वॉलेट का पैसा ख़र्च किए बिना सिम्युलेटेड नंबर और कोड पाने के लिए डेवलपमेंट अकाउंट पर सैंडबॉक्स मोड माँगें।

सेवाओं के नाम उनके संबंधित स्वामियों के ट्रेडमार्क हैं। OTP Route का उनसे कोई संबंध नहीं है। नंबरों का उपयोग कानूनी रूप से करें तथा प्रत्येक सेवा की शर्तों और हमारी स्वीकार्य उपयोग नीति का पालन करें।