Smart OTP कैसे use करें (Smart OTP kaise use kare): template, fallback और API

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 सेट करें

  1. 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 दबाएं।

    Add OTP Template, SMS Channel: entity Demo Traders, sender DEMOTR, template चुना हुआ और Variable 1 (Selected)
    OTP वाला variable चुनना ज़रूरी है।

    एक DLT template से एक ही Smart OTP template बन सकता है। दोबारा कोशिश करने पर “You have already created an OTP template for this DLT content.” दिखता है।

  2. या WhatsApp OTP template बनाएं

    उसी window में WhatsApp Channel पर क्लिक करें। Select WhatsApp Business Number और फिर Select WhatsApp Template (Authentication/Utility) चुनें। Marketing templates यहां कभी नहीं दिखते। OTP variable चुनें और Assign OTP Template दबाएं।

    Add OTP Template, WhatsApp Channel: नंबर Demo Traders +91 90000 00001, template login_otp और Variable 1 (Selected)
    Save होते ही template active हो जाता है, अलग approval नहीं लगता।
  3. दूसरे 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 करें।

    SET FALLBACK TEMPLATE टिक, Configure Channel Fallback, Fallback Channel WhatsApp, नंबर और login_otp template चुना हुआ
    SMS fail हुआ तो वही OTP WhatsApp पर जाएगा।
  4. 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 सेकंड रहती है।

    OTP Settings पेज: Max Verify OTP Limit 5 और SMS Resend Time Limit 30 सेकंड, Save Settings बटन
    ये settings SMS और WhatsApp दोनों OTP पर लागू होती हैं।
  5. 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 window जिसमें OTP ID, Mobile Number और Send Test OTP बटन है
    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 अपने आप भरता है।
Sample Code window के JSON में “// optional” जैसे notes होते हैं। भेजने से पहले उन्हें हटा दें, क्योंकि JSON में comments नहीं चलते।

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 डाल सकता है।

OTP Delivery Details में दो rows: SMS पर Failed और WhatsApp पर Delivered, एक ही Request ID
OTP report में fallback दूसरी row के रूप में दिखता है।

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 में।

संबंधित गाइड