دسته «پیامک و رمز یکبار مصرف» فینوتک ۸ سرویس برای ارسال پیامک، چرخه رمز یکبار مصرف، و دریافت وضعیت یا پیام ورودی دارد. استعلام هویتی و صدور توکن دسترسی در این دسته نیست؛ کار اینجا اطلاعرسانی و تایید مالکیت شماره است.
درباره دسته پیامک و رمز یکبار مصرف
سرویسهای این دسته سه خانواده دارند. خانواده نخست ارسال است: فینوتکست — ارسال پیامک گروهی فهرستی از مقصدها و متن هر شماره را با سرشماره کلاینت شما میفرستد؛ ارسال پیامک کد تأیید (OTP) همان کانال را برای کدی که خودتان ساختهاید به کار میبرد. خانواده دوم، چرخه حیات رمز یکبار مصرف است: ثبت درخواست ارسال رمز یکبار مصرف (Initiate) تراکنش را باز میکند و صحتسنجی رمز یکبار مصرف (Verify) کد واردشده را میسنجد؛ تولید و نگهداری خود کد در سمت شما نیست.
خانواده سوم به دیدن سرنوشت پیام و شنیدن پاسخ کاربر مربوط است. وضعیت تحویل را میتوانید با استعلام فینوتکست بخوانید یا با وبهوک دریافت وضعیت پیامک همان لحظه بگیرید. پیام ورودی به سرشماره را یا دورهای با دریافت پیامک میخوانید یا با وبهوک دریافت پیامک دریافت میکنید. مرز این دسته روشن است: توکن دسترسی کاربر در دسته OAuth و توکن صادر میشود و تطبیق موبایل با کد ملی در دسته احراز هویت و شناخت مشتری است.
کاربردهای کسبوکاری پیامک و رمز یکبار مصرف
- ثبتنام و ورود بدون رمز ثابت — مالکیت شماره با زوج ثبت درخواست ارسال رمز یکبار مصرف (Initiate) و صحتسنجی رمز یکبار مصرف (Verify) تایید میشود.
- تایید عملیات حساس در کیف پول — اگر کد را خودتان میسازید، ارسال پیامک کد تأیید (OTP) همان کد را میفرستد.
- اطلاعرسانی انبوه سررسید و تراکنش — یادآوری قسط، اعلام واریز یا اطلاعیه بیمه با فینوتکست به فهرست مقصدها میرود.
- پایش تحویل پیش از پیگیری دستی — نرسیدن پیام با وبهوک وضعیت یا استعلام فینوتکست دیده میشود و ارسال دوباره همانجا تصمیم گرفته میشود.
- کانال پاسخ دوطرفه با مشتری — پاسخ کاربر به سرشماره با وبهوک دریافت یا دریافت پیامک به پرونده وصل میشود.
- لغو اشتراک و دستورهای متنی — متن ورودی مبنای انصراف از اطلاعرسانی یا ثبت درخواست ساده در سامانه عملیاتی است.
انتخاب سرویس مناسب در پیامک و رمز یکبار مصرف
- میخواهم سامانه OTP را از صفر نسازم — از ثبت درخواست ارسال رمز یکبار مصرف (Initiate) شروع کنید و تصمیم ورود را فقط پس از صحتسنجی رمز یکبار مصرف (Verify) بگیرید.
- کد را خودم تولید میکنم و فقط باید ارسال شود — ارسال پیامک کد تأیید (OTP). این سرویس صحت کد را نمیسنجد.
- یک متن متفاوت برای هر شماره در یک دسته — فینوتکست — ارسال پیامک گروهی.
- میخواهم بدانم پیام به دست مشترک رسیده یا نه — اگر نمیخواهید استعلام دورهای بنویسید، وبهوک دریافت وضعیت پیامک؛ اگر دستهای را بعداً میخوانید، استعلام فینوتکست.
- کاربر به سرشماره من پیام میدهد — برای واکنش همان لحظه وبهوک دریافت پیامک؛ برای جمعآوری بازهای دریافت پیامک.
- تفاوت این OTP با توکن پیامکی چیست؟ — اینجا مالکیت شماره تایید میشود. اجازه دسترسی به اسکوپهای فینوتک در دسته OAuth و توکن گرفته میشود.
شروع کار با پیامک و رمز یکبار مصرف
فراخوانیهایی که شما به فینوتک میزنید با رویکرد Client Credential است. وبهوکها مسیر ورودیاند: شما نشانی را منتشر میکنید و فینوتک با احراز Basic شناسه و کلید کلاینت به همان نشانی درخواست میفرستد. ابتدا کلاینت بسازید، اسکوپ همان سرویس را فعال کنید و توکن بگیرید: راهنمای شروع.
سرشماره باید به کلاینت شما اختصاص یافته باشد. شناسه پیگیری ارسال را نگه دارید تا وضعیت را به همان دسته گره بزنید. مشخصات فنی هر سرویس از صفحه کسبوکاری آن در فهرست پایین در دسترس است.
سوالات متداول پیامک و رمز یکبار مصرف
این دسته پیامک بانکی و شاهکار هم هست؟
خیر. کار اینجا ارسال، رمز یکبار مصرف و دریافت وضعیت یا پیام ورودی است. تطبیق موبایل و کد ملی در دسته احراز هویت است.
چه نوع توکنی لازم است؟
فراخوانیها با توکن Client Credential انجام میشود. وبهوک مسیر ورودی به سامانه شماست و شما آن را فراخوانی نمیکنید.
چرخه Initiate و Verify با ارسال پیامک کد تأیید چه فرقی دارد؟
در چرخه Initiate و Verify تولید و سنجش کد در سرویس انجام میشود. در ارسال پیامک کد تأیید، شما کد را میسازید و فقط متن را میفرستید.
اگر وبهوک تنظیم نکنم، وضعیت را از دست میدهم؟
خیر. میتوانید وضعیت همان دسته را با استعلام فینوتکست بخوانید؛ وبهوک فقط استعلام دورهای را حذف میکند.
آیا این سرویسها توکن دسترسی به استعلامهای فینوتک میدهند؟
خیر. صدور توکن در دسته OAuth و توکن است.
مستندات فنی هر سرویس کجاست؟
از فهرست پایین وارد صفحه هر سرویس شوید؛ پیوند مشخصات API همانجا است.
فهرست سرویسهای پیامک و رمز یکبار مصرف
- ارسال پیامک کد تأیید (OTP) — این سرویس هنگامی به کار میرود که قصد دارید با سرشماره مشخص، پیامک کد تأیید ارسال کنید. (مستندات فنی)
- استعلام فینوتکست — با inquiryTrackId (همان trackId فراخوانی فینوتکست)، وضعیت ارسال پیامکهای ارسالی استعلام میشود. (مستندات فنی)
- ثبت درخواست ارسال رمز یکبار مصرف (Initiate) — سرویس یکپارچه مدیریت چرخه حیات OTP — در این مرحله با ارسال شناسه کاربر و انتخاب کانال (SMS، USSD یا Bot)، فرآیند تولید رمز آغاز شده و traceId برای مرحله بعد صادر میگردد. (مستندات فنی)
- دریافت پیامک — با وارد کردن سرشماره (destinationNumber) و بازه تاریخ شمسی (startDateTime / endDateTime)، پیامکهای دریافتشده روی آن سرشماره برگردانده میشود. (مستندات فنی)
- صحتسنجی رمز یکبار مصرف (Verify) — با وارد کردن کد دریافتشده توسط کاربر و traceId مرحله Initiate، صحت رمز بررسی شده و نتیجه نهایی اعلام میگردد. (مستندات فنی)
- فینوتکست — ارسال پیامک گروهی — سرویس ارسال پیامک؛ هنگامی به کار میرود که قصد دارید با یک سرشماره، پیامک گروهی ارسال کنید. (مستندات فنی)
- وبهوک دریافت پیامک — جهت دریافت پیامکهای ارسالی به سرشمارههای اختصاصی، مشترک باید این endpoint را در اختیار فینوتک قرار دهد. (مستندات فنی)
- وبهوک دریافت وضعیت پیامک — جهت دریافت وضعیت تحویل پیامک پس از ارسال، مشترک باید این endpoint را در اختیار فینوتک قرار دهد. (مستندات فنی)