Smart OTP कैसे use करें: Fast2SMS में Smart OTP app खोलें, Add OTP Template से अपना approved DLT या WhatsApp template चुनें, OTP वाला variable चुनें और चाहें तो दूसरे channel पर fallback जोड़ें। आपको एक OTP ID मिलेगी। फिर अपनी website या app से Send OTP API में mobile नंबर और OTP ID भेजें, और customer के डाले code को Verify OTP API से जांचें। Smart OTP हमारा सुझाया तरीका है क्योंकि यह priority route से जाता है और SMS fail होने पर WhatsApp (या उल्टा) पर वही OTP भेज देता है।
शुरू करने से पहले
- Fast2SMS account और wallet में balance। हर OTP का पैसा कटता है, test और resend समेत।
- SMS OTP के लिए: DLT Manager में approved Entity ID, Sender ID और कम से कम एक variable वाला OTP content template।
- WhatsApp OTP के लिए: WhatsApp Manager में connected WhatsApp Business नंबर और approved Authentication या Utility template।
- API के लिए अपनी API key, जो API Key पेज पर मिलती है।
Panel में Smart OTP सेट करें
-
SMS OTP template बनाएं
Smart OTP app में OTP Template List खोलें और Add OTP Template दबाएं। SMS Channel पर रहें। Select Entity, फिर Select Sender, फिर Select Template चुनें। सिर्फ वही approved templates दिखते हैं जो उस sender से जुड़े हों और जिनमें कम से कम एक variable हो। OTP Content Preview के नीचे उस variable पर क्लिक करें जिसमें OTP जाएगा, वह “Variable 1 (Selected)” जैसा दिखेगा। Assign OTP Template दबाएं।

OTP वाला variable चुनना ज़रूरी है। एक DLT template से एक ही Smart OTP template बन सकता है। दोबारा कोशिश करने पर “You have already created an OTP template for this DLT content.” दिखता है।
-
या WhatsApp OTP template बनाएं
उसी window में WhatsApp Channel पर क्लिक करें। Select WhatsApp Business Number और फिर Select WhatsApp Template (Authentication/Utility) चुनें। Marketing templates यहां कभी नहीं दिखते। OTP variable चुनें और Assign OTP Template दबाएं।

Save होते ही template active हो जाता है, अलग approval नहीं लगता। -
दूसरे channel पर fallback जोड़ें
Save करने से पहले SET FALLBACK TEMPLATE पर टिक करें। SMS template का fallback WhatsApp होता है: नंबर, template और OTP variable चुनें। WhatsApp template का fallback SMS होता है: entity, sender, DLT template और variable चुनें। बाद में बदलना हो तो card पर Fallback बटन दबाएं, हटाना हो तो टिक हटाकर save करें।

SMS fail हुआ तो वही OTP WhatsApp पर जाएगा। -
OTP Settings तय करें
OTP Settings खोलें। Max Verify OTP Limit (Per SMS) बताता है कि एक OTP को कितनी बार verify करने की कोशिश हो सकती है (1 से 100)। SMS Resend / Time Limit (Seconds) वह इंतज़ार है जिसके बाद वही template उसी नंबर पर उसी channel से फिर जा सकता है (0 से 3600, 0 यानी कोई इंतज़ार नहीं)। Save Settings दबाएं। अगर यह पेज कभी save नहीं किया, तो limit 10 कोशिशें और 10 सेकंड रहती है।

ये settings SMS और WhatsApp दोनों OTP पर लागू होती हैं। -
Test OTP भेजें
Card पर Test OTP दबाएं, 10 अंकों का mobile नंबर डालें और Send Test OTP दबाएं। Window “Message sent. Checking DLR…” दिखाकर operator की report का इंतज़ार करती है, फिर “Delivered successfully” या fail होने का कारण बताती है। 30 सेकंड में report न आए तो “Delivery report pending” के साथ OTP report का link दिखता है।

Test OTP असली message है और इसका पैसा API send की तरह कटता है।
Smart OTP API: send, verify और resend
Card पर Sample Code से cURL, PHP, Node.js या Python में तैयार code मिलता है, जिसमें उस card की OTP ID भरी होती है। तीनों API POST (JSON) या GET दोनों से चलती हैं। API key को authorization header में बिल्कुल वैसे ही भेजें, आगे “Bearer” न लगाएं।
1. OTP भेजें
curl -X POST 'https://www.fast2sms.com/dev/otp/send' \
-H 'authorization: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"mobile":"9999999999","otp_id":"YOUR_OTP_ID","otp_expiry":15,"otp_length":6}'
सफल होने पर जवाब: {"return":true,"status_code":200,"request_id":"O...","message":"OTP sent successfully"}
| Parameter | ज़रूरी | काम |
|---|---|---|
| mobile | हां | 10 अंकों का नंबर। आगे का 91 हटा दिया जाता है। |
| otp_id | हां | Template card की OTP ID। |
| otp_expiry | नहीं | OTP कितने मिनट valid रहे, 1 से 10080। डिफ़ॉल्ट 15। |
| otp_length | नहीं | 4 से 10 अंक। डिफ़ॉल्ट 6। |
| otp | नहीं | अपना OTP, 10 अक्षर तक। |
| variables_values | नहीं | Template के बाकी variables की values, | से अलग। OTP वाला variable अपने आप भरता है। |
2. Customer का डाला OTP verify करें
curl -X POST 'https://www.fast2sms.com/dev/otp/verify' \
-H 'authorization: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"mobile":"9999999999","otp":"123456"}'
सही होने पर HTTP 200 और “OTP verified successfully” आता है। Customer को सिर्फ इसी जवाब पर अंदर जाने दें। OTP को string (“123456”) के रूप में भेजें।
3. वही OTP दोबारा भेजें
curl -X POST 'https://www.fast2sms.com/dev/otp/resend' \
-H 'authorization: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"mobile":"9999999999"}'
Resend वही OTP उसी OTP ID और expiry के साथ फिर भेजता है और नई request ID देता है। यह पहली बार भेजने के 10 मिनट के अंदर और कुल 5 बार (पहली बार मिलाकर) तक चलता है। हर resend का पैसा अलग कटता है।
लिखते समय SMS OTP आपके bulk SMS slab rate (₹0.25 से ₹0.11 प्रति SMS) पर और WhatsApp OTP ₹0.25 प्रति message पर कटता है। ताज़ा rates OTP SMS पेज पर देखें।
Sending in bulk? For high OTP volumes our team offers discounted rates. Talk to our team or see OTP pricing.
Fallback कैसे काम करता है
अगर पहला message भेजने के 120 सेकंड के अंदर failed report होता है, तो Fast2SMS वही OTP एक बार fallback channel पर भेजता है। Fallback का पैसा उसके channel के हिसाब से अलग कटता है। Wallet में balance कम हो, या WhatsApp fallback का नंबर connected न हो, तो fallback नहीं जाता। Customer दोनों में से किसी भी message का वही code डाल सकता है।

API के जवाब और errors
| API | Message | क्या करें |
|---|---|---|
| कोई भी | Authorization key required / Invalid authorization key | Key को authorization header में बिना “Bearer” के भेजें। |
| कोई भी | IP is blacklisted from Dev API section | API Security चालू है। अपने server का IP Whitelisted IPs में जोड़ें। |
| Send | Invalid OTP ID | ID जांचें। Delete हुए template की ID काम नहीं करती। |
| Send | Please wait N seconds before requesting a new OTP | OTP Settings का resend इंतज़ार अभी चल रहा है। |
| Send | Insufficient wallet balance | Wallet recharge करें। |
| Verify | Invalid OTP | गलत code। Limit तक फिर कोशिश हो सकती है। |
| Verify | OTP expired | नया OTP भेजें। |
| Verify | Maximum verification attempts reached. OTP is no longer valid. | नया OTP भेजें। |
| Verify | OTP not found or already verified | नीचे “Verify fail” देखें। |
| Resend | OTP resend window (10 minutes) has expired | Send API फिर से call करें। |
| Resend | Maximum resend limit (5 times) reached | कुछ देर बाद Send API call करें। |
आम दिक्कतें
Verify fail, जबकि code सही लगता है
Verify उस नंबर के सबसे नए unverified OTP को ही जांचता है। उसी नंबर पर नया OTP भेजते ही पुराने सारे OTP बेकार हो जाते हैं, चाहे OTP ID अलग हो। अगर customer ने दो बार “send” दबाया और पहला code डाला, तो verify fail होगा। Customers को सबसे नए message का code डालने को कहें, या Resend इस्तेमाल करें जो वही code दोबारा भेजता है।
OTP नहीं पहुंचा
OTP report में नंबर खोजें। Failed है तो Delivery Details में कारण देखें। Pending या Sent है तो operator की पुष्टि बाकी है। Fallback लगाएं ताकि एक channel fail होने पर दूसरा काम आए। अगर API ने error दिया था, तो OTP भेजा ही नहीं गया, API Logs देखें।
अक्सर पूछे जाने वाले सवाल
क्या Smart OTP template को approval चाहिए?
नहीं। DLT या WhatsApp template पहले से approved होता है, इसलिए Smart OTP template save होते ही active हो जाता है।
क्या resend नया OTP भेजता है?
नहीं, वही OTP दोबारा भेजता है। नया code चाहिए तो Send API फिर call करें।
क्या अपना OTP code भेज सकते हैं?
हां, otp parameter में, 10 अक्षर तक। न भेजें तो Fast2SMS आपकी बताई लंबाई का code बनाता है।
Fallback का पैसा कटता है?
हां। Fallback message अपने channel पर अलग कटता है और Transaction History में “Fallback” के साथ दिखता है।
क्या DLT SMS API से भी OTP भेज सकते हैं?
हां, अपने approved DLT OTP template से DLT SMS API या DLT Manual API से। तब OTP बनाना और जांचना आपके app को करना होगा। Smart OTP में यह सब built-in है।
Template delete करने पर क्या होता है?
Delete के लिए account password लगता है, और उस template की OTP ID सभी API calls में invalid हो जाती है। नया template बनाकर code में नई OTP ID डालें।
कौन से customers ने OTP verify किया, यह कहां दिखेगा?
OTP report की Export file में Verified (Yes, No या Expired) और Verified At columns में।