سرویس «ارسال پیامک کد تأیید (OTP)» در دسته پیامک و رمز یکبار مصرف فینوتک، متن کد تأییدی که خودتان تولید کردهاید را با سرشماره مشخص به شماره مقصد میفرستد و در پاسخ تعداد شمارههای ارسالشده و تعداد پیامکهای مصرفشده را برمیگرداند. با این سرویس میتوانید مرحله تأیید شماره موبایل در ثبتنام، ورود یا تأیید پرداخت را بدون وابستگی به ابزار بیرونی و درون جریان خودتان اجرا کنید.
ارسال پیامک کد تأیید (OTP) چه مشکلی را حل میکند؟
تأیید شماره موبایل، دروازه ورود کاربر به هر محصول مالی است و هر ثانیه تأخیر در آن بهطور مستقیم روی نرخ تکمیل ثبتنام اثر میگذارد. کسبوکارهایی که مسیر روشنی برای ارسال کد تأیید ندارند، ناچار میشوند تأیید شماره را به مرحلهای دیگر موکول کنند یا آن را به فرم تماس و تأیید تلفنی توسط پشتیبانی بسپارند؛ هر دو راه هم پرهزینه است و هم پرونده کاربر را نیمهکاره رها میکند. در جریان پرداخت هم نبود یک کانال قابل اتکا برای ارسال کد، یعنی رهاکردن تراکنش در آخرین قدم.
این سرویس همان مرحله را به یک فراخوانی ساده تبدیل میکند: سرشماره مشخص، شماره مقصد و متن پیام حاوی کد را میفرستید و پاسخ نشان میدهد که ارسال پذیرفته شده است. تولید و اعتبارسنجی کد در این حالت در سمت خود شما انجام میشود، پس اگر سامانهای دارید که کد و مدت اعتبار آن را مدیریت میکند، فقط به یک مسیر ارسال نیاز دارید. اگر میخواهید مدیریت کل چرخه حیات رمز — تولید، ارسال و صحتسنجی — بر دوش فینوتک باشد، جفت سرویس ثبت درخواست ارسال رمز یکبار مصرف (Initiate) و صحتسنجی رمز یکبار مصرف (Verify) انتخاب مناسبتری است.
کاربردهای ارسال پیامک کد تأیید (OTP)
- ثبتنام و تأیید شماره موبایل در اپلیکیشن — کد تأیید در همان صفحه ورود شماره ارسال میشود و کاربر بدون ترک فرم، مالکیت شماره را اثبات میکند.
- ورود دومرحلهای به پنل کاربری و پنل مدیریت — علاوه بر رمز عبور، یک کد پیامکی برای نشستهای حساس یا دستگاه ناشناس فرستاده میشود.
- تأیید پرداخت و تراکنش در کیف پول — پیش از برداشت وجه یا تغییر حساب مقصد، کد تأیید به شماره ثبتشده کاربر ارسال میشود.
- تأیید عملیات حساس در سامانههای مالی و بیمه — تغییر شماره حساب، افزودن ذینفع یا تأیید درخواست خسارت با کد پیامکی مهر میشود.
- بازیابی رمز عبور — کد بازیابی به شماره موبایل کاربر میرود و نیاز به تماس با پشتیبانی برای ریست دستی از بین میرود.
- تأیید تحویل و هویت مأمور در لجستیک — کد تحویل مرسوله برای گیرنده ارسال میشود و مبنای تأیید تحویل قرار میگیرد.
مزایای ارسال پیامک کد تأیید (OTP)
- مسیر مستقیم برای یک شماره مقصد — بدون نیاز به ساختن فهرست و منطق ارسال گروهی، پیام تأیید به شماره مورد نظر فرستاده میشود.
- کنترل کامل متن پیام — قالب متن، جای کد و عبارتهای امنیتی را خودتان تعیین میکنید و میتوانید آن را با برند و زبان محصول هماهنگ کنید.
- ارسال از سرشماره مشخص — پیام تأیید همیشه از سرشمارهای که تعیین کردهاید فرستاده میشود و برای کاربر آشنا میماند.
- بازخورد قابل ثبت در گزارشها — تعداد ارسال و تعداد پیامکهای مصرفشده در پاسخ میآید و برای شمارش و تحلیل مصرف قابل استفاده است.
- پیگیری وضعیت پس از ارسال — با شناسه پیگیری همان فراخوانی میتوانید وضعیت ارسال را استعلام کنید و علت ناکامیهای احتمالی را در پشتیبانی نشان دهید.
چه چیزی از ارسال پیامک کد تأیید (OTP) دریافت میکنید؟
جزئیات ورودی، خروجی و نمونه پاسخ در مستندات فنی آمده است.
جریان کار ارسال پیامک کد تأیید (OTP)
- ۱. ساخت کلاینت و گرفتن توکن — با اسکوپ
facility:finnotext-otp:postتوکن Client Credential بگیرید. - ۲. تولید کد در سمت خودتان — کد تأیید را بسازید، آن را با مدت اعتبار و شماره کاربر در سمت سرور نگه دارید و متن پیام را آماده کنید.
- ۳. ارسال پیامک — سرشماره، شماره مقصد و متن پیام را همراه یک
trackIdیکتا بفرستید. - ۴. صحتسنجی کد واردشده — کدی که کاربر در فرم وارد میکند را با مقدار ذخیرهشده در سمت سرور مقایسه کنید و پس از مصرف یا انقضا آن را بیاعتبار کنید.
- ۵. ثبت سابقه و پیگیری — شناسه پیگیری و نتیجه تأیید را برای رسیدگی به گزارشهای «کد را دریافت نکردم» ذخیره کنید و در صورت نیاز وضعیت ارسال را از استعلام فینوتکست بگیرید.
نحوه شروع ارسال پیامک کد تأیید (OTP)
این سرویس با رویکرد Client Credential (بدون رضایت پیامکی) فراخوانی میشود. اسکوپ مورد نیاز: facility:finnotext-otp:post. ابتدا کلاینت بسازید و توکن بگیرید: راهنمای شروع. سپس از مستندات فنی برای پیادهسازی استفاده کنید.
محدودیتها و نکات ارسال پیامک کد تأیید (OTP)
- تولید کد، مدت اعتبار آن و بررسی درستی کد در این سرویس انجام نمیشود؛ این سرویس فقط متن پیام را ارسال میکند و بقیه منطق در سمت شما است.
- کد تأیید را در سمت سرور نگه دارید، پس از یکبار مصرف بیاعتبار کنید و برای درخواستهای پرتکرار از یک شماره، محدودیت تعریف کنید.
- شناسه پیگیری هر فراخوانی حداکثر ۴۰ کاراکتر حرف و عدد است و استفاده از UUID توصیه میشود؛ برای هر ارسال مقدار یکتا بفرستید.
- پاسخ موفق به معنای پذیرش ارسال است و تحویل به گوشی کاربر را تضمین نمیکند؛ در رابط کاربری امکان ارسال دوباره را با فاصله زمانی پیشبینی کنید.
- متن پیام روی گوشی کاربر باقی میماند؛ در آن اطلاعات اضافهای جز کد و هدف استفاده از آن قرار ندهید.
- وضعیت ارسال پیامها را میتوانید با سرویس استعلام پیگیری کنید یا مسیر دریافت خودکار وضعیت تحویل را با وبهوک وضعیت پیامک فعال کنید.
سوالات متداول ارسال پیامک کد تأیید (OTP)
«ارسال پیامک کد تأیید (OTP)» چیست؟
سرویسی است که متن پیامک حاوی کد تأیید را با سرشماره مشخص به یک شماره مقصد ارسال میکند و تعداد ارسال و تعداد پیامک مصرفشده را در پاسخ برمیگرداند.
تفاوت این سرویس با سرویسهای Initiate و Verify چیست؟
در این سرویس کد را خودتان تولید و بررسی میکنید و فینوتک فقط ارسال را انجام میدهد؛ اگر میخواهید تولید، ارسال و صحتسنجی رمز بهصورت یکپارچه مدیریت شود، از ثبت درخواست ارسال رمز یکبار مصرف (Initiate) و صحتسنجی رمز یکبار مصرف (Verify) استفاده کنید.
تفاوت آن با ارسال پیامک گروهی چیست؟
این سرویس برای ارسال پیام تأیید به شماره مقصد است؛ برای اطلاعرسانی به فهرستی از مخاطبان از فینوتکست — ارسال پیامک گروهی استفاده کنید.
اگر کاربر بگوید کد را دریافت نکرده است چه کنم؟
وضعیت ارسال همان فراخوانی را با استعلام فینوتکست بررسی کنید و بر اساس نتیجه، ارسال دوباره یا مسیر جایگزین تأیید را به کاربر پیشنهاد دهید.
مستندات فنی این سرویس کجاست؟
صفحه مشخصات API شامل endpoint، پارامترها و نمونه پاسخ است.
چه نوع احراز هویتی لازم است؟
Grant type: client_credentials. جزئیات در راهنمای توکن.
آیا رضایت پیامکی کاربر لازم است؟
خیر. این سرویس با Client Credential و بدون رضایت پیامکی قابل فراخوانی است.
مستندات فنی ارسال پیامک کد تأیید (OTP)
مشاهده مستندات فنی «ارسال پیامک کد تأیید (OTP)» — endpoint، پارامترها، نمونه درخواست و پاسخ.