معرفی کد USSD (برای پرداخت وجه، دریافت اطلاعات، ثبت اطلاعات و ...) و بیان روش هایی برای اجرای کدهای USSD در برنامه نویسی اندروید (به همراه ارائه یک پروژه اندروید)

احتمالا تاکنون با کد USSD آشنا شده اید. مثلا بانک شما، یک شماره شامل یک سری حروف خاص و شماره هایی در بین آنها را به شما می دهد و با شماره گیری آن کد USSD ، یک سری اطلاعات به شما نمایش داده می شود که با انتخاب هایی، می توانید به مشاهده اطلاعات، تغییر اطلاعات و یا حتی پرداخت وجه، اقدام نمایید.

در واقع، کدهای USSD ، ساز و کارهایی از پیش تعریف شده هستند که امکان ایجاد یک ارتباط بین ما و شبکه تلفن همراه (و سایر شبکه هایی که به آن متصل شده اند) را به ما می دهند و این ارتباط، به سادگی شماره گیری یک کد می باشد (مثل زمانی که شماره یکی از دوستانمان را شماره گیری می کنیم).

معمولا بانک ها و شرکت های مختلف، کد USSD مختص خود را دارند (طی قراردادی که با اپراتورهای تلفن همراه بسته اند). در واقع، اولین شماره موجود در کد USSD ، مختص یک بانک یا شرکت است و بعد، با قرار دادن یک علامت (علامت *)، شماره های دیگری در ساختار کد USSD قرار می گیرند که بستگی به ساز و کار آن سیستم تعریف شده برای آن بانک یا شرکت دارد.

به عنوان مثال، کد USSD اصلی مربوط به بانک ملت (شرکت به پرداخت ملت)، عبارت است از :

همان طور که مشاهده می کنید، در ابتدای کد USSD ، علامت * و در انتهای آن، علامت # قرار می گیرد. بنابراین چنانچه کد USSD بالا را شماره گیری کنیم، به سیستم متناظر با آن که مرتبط با بانک ملت است، متصل می شویم (مستقل از برنامه های اندروید نصب بر روی گوشی) :

معرفی کد USSD (برای پرداخت وجه، دریافت اطلاعات، ثبت اطلاعات و ...) و بیان روش هایی برای اجرای کدهای USSD در برنامه نویسی اندروید (به همراه ارائه یک پروژه اندروید)

راهنمای خود شرکت (در یک pdf) را در لینک زیر برای دانلود قرار داده ام، در صورت تمایل، می توانید نگاهی به ان بیندازید (تنها برای مبحث آموزشی، برای سایر استفاده ها، راهنما را از سایت اصلی شرکت دریافت کنید) :

دانلود راهنمای کد USSD برای شرکت به پرداخت ملت

پیام بالا نمایش دهنده آن است که یک کد USSD را شماره گیری کرده ایم و اکنون اپراتور تلفن همراه در حال پردازش آن است. سپس بر اساس ساختار مربوط به آن، گزینه های زیر نمایش داده می شود :

مشاهده می کنید که چند گزینه برای انتخاب نمایش داده شده است. بنابراین باید یک عدد بین 1 تا 7 را متناسب با گزینه انتخابی، در کادر وارد کرده و بر روی دکمه send اشاره کنیم. مثلا اگر عدد 1 را انتخاب کنیم، انتخاب های مربوط به مرحله دوم به صورت زیر نمایش داده می شود :

در همینجا این نکته مهم را ذکر می کنم که ساز و کار کدهای USSD به این صورت است که کاربر می تواند انتخاب های خود را در ادامه کد ذکر کند، یعنی در همان ابتدای شماره گیری، چون می داند در مرحله اول می خواهد گزینه شماره 1 را انتخاب کند، این انتخاب را در کد USSD ذکر کرده و سپس آن را شماره گیری می کند تا دیگر مرحله اول به وی نمایش داده نشود. یعنی کد USSD که شماره گیری می کنیم، به صورت زیر خواهد بود :

یک علامت * را بعد از عدد 712 قرار داده ایم و بعد عدد 1 که همان انتخاب ما برای مرحله اول است را قید کرده ایم. علامت # هم همیشه در انتهای کد قرار می گیرد. پس با شماره گیری کد بالا، مستقیما مرحله دوم نمایش داده می شود :

شماره گیری کد USSD توسط برنامه اندروید :

همان طور که بیان کردیم، کد USSD را با شماره گیری دستی می توان اجرا کرد. اما ما در برنامه نویسی اندروید، نیاز به اجرای آن توسط یک سری کد داریم که مثلا تعدادی از انتخاب های کاربر را توسط تعدادی عنصر Edittext دریافت کرده و آنها را در کد USSD قید کنیم و بعد با اشاره بر روی یک دکمه (Button)، کد USSD شماره گیری شود.

برای این منظور، یک پروژه اندروید را برای دانلود قرار داده ام که در آن، دو حالت کدنویسی شده است. یکی زمانی که تنها کد اصلی USSD اجرا می شود و بعد کاربر باید تمامی انتخاب ها را در ((ارتباط اصلی)) وارد کند و حالت دوم، زمانی است که کاربر یک یا چند انتخاب اول خود را در ((خود برنامه اندروید ما)) وارد می کند و بعد کد USSD را متناسب با انتخاب های وی ساخته و شماره گیری می کنیم. دقت کنید منظورمان از ((ارتباط اصلی))، ارتباطی است که بعد از شماره گیری کد USSD توسط برنامه اندروید ما، بین کاربر و شبکه تلفن همراه برقرار می شود و ما دیگر تسلطی بر آن نداریم (منطقی است، چون مثلا اگر می توانستیم اجرای آن را رصد کنیم، اطلاعات مربوط به کارت عابر بانک و رمز عبوری که کاربر در آن مراحل وارد می کند، قابل سرقت بود).

لایه گرافیکی برنامه اندروید به صورت زیر می باشد :

با اشاره بر روی دکمه اول، همان کد USSD اصلی شماره گیری می شود. اما اگر کاربر بخواهد که انتخاب مرحله اول را در خود برنامه اندروید ما تعیین کند، در پایین صفحه، شماره مورد نظرش را در عنصر EditText وارد کرده (به عنوان مثال ما نوشته ایم که عدد 1 یا 2 را انتخاب کند) و بعد بر روی دکمه دوم (در پایین صفحه)، اشاره می کند تا ما انتخاب وی را از EditText دریافت کرده و به کد USSD اصلی اضافه می کنیم و سپس شماره گیری کد USSD شروع می شود (در صورت تمایل، می توانید کدهایی را برای چک کردن صحت اطلاعات ورودی کاربر اجرا کنید، یعنی مراقب باشید که یک وقت کاربر خودش یک سری کد USSD را در این مرحله وارد نکند که ناخواسته، فرآیندی غیر از فرآیند مورد نظر شما اجرا شود، در کل هر وقت از کاربران ورودی دریافت می کنید، مراقب کاربران کنجکاو باشید !).

لینک های دانلود :

دانلود فایل های پروژه اندروید

دانلود فایل apk برنامه اندروید

اما اکنون کدهای برنامه اندروید را شرح می دهیم.

کدهای فایل activity_main.xml که لایه گرافیکی متناظر برای Activity را تعریف می کند :

<?xml version="1.0" encoding="utf-8"?>
<ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >
   
        <LinearLayout
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            android:orientation="vertical"
            android:paddingBottom="@dimen/activity_vertical_margin"
            android:paddingLeft="@dimen/activity_horizontal_margin"
            android:paddingRight="@dimen/activity_horizontal_margin"
            android:paddingTop="@dimen/activity_vertical_margin" >
       
            <TextView
                android:id="@+id/textView1"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:layout_margin="5dp"
                android:text="شماره گیری کد اصلی :" />
       
            <Button
                android:id="@+id/button1"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="Dial USSD Code (Main Code)" />
           
            <View
                    android:layout_width = "fill_parent"
                    android:layout_height="10dp"
                    android:layout_marginTop="20dp"
                    android:layout_marginBottom="20dp"
                    android:background="#FF0000" />
           
            <TextView
                android:id="@+id/textView1"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:layout_margin="5dp"
                android:text="شماره گیری با یک مرحله انتخاب شده :" />
           
            <EditText
                android:id="@+id/editText1"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:hint="please enter number 1 or 2"
                android:ems="10" >
       
                <requestFocus />
            </EditText>
           
            <Button
                android:id="@+id/button2"
                android:layout_width="match_parent"
                android:layout_height="wrap_content"
                android:text="Dial USSD Code (With Level 1 choice)" />
       
        </LinearLayout>

</ScrollView>

که در آن، دو دکمه (Button)، دو TextView ، یک EditText و یک خط افقی را تعریف کرده ایم. همچنین از ScrollView برای ایجاد امکان اسکرول به بالا و پایین (برای مواقعی که کل محتوا از اندازه صفحه نمایش بزرگتر است) استفاده نموده ایم.

کدهای فایل MainActivity.java که همان Activity اصلی برنامه اندروید است :

package com.kelidestan.ussd_example;

import android.app.Activity;
import android.content.Intent;
import android.net.Uri;
import android.os.Bundle;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;

public class MainActivity extends Activity {

@Override
        protected void onCreate(Bundle savedInstanceState) {
                super.onCreate(savedInstanceState);
                setContentView(R.layout.activity_main);
               
                Button b_1 = (Button) findViewById(R.id.button1);
                b_1.setOnClickListener(new OnClickListener() {
                                                 
                    @Override
                    public void onClick(View v) {
                        String USSD_code = "tel:" + "*712#";
                        String encodedHash = Uri.encode("#");
                        USSD_code = USSD_code.replace("#", encodedHash);
                        Intent callIntent = new Intent(Intent.ACTION_CALL, Uri.parse(USSD_code)); //must add permission in AndroidManifest.xml : <uses-permission android:name="android.permission.CALL_PHONE"></uses-permission>
                        startActivity(callIntent);
                    }
                });
               
                Button b_2 = (Button) findViewById(R.id.button2);
                b_2.setOnClickListener(new OnClickListener() {
                                                 
                    @Override
                    public void onClick(View v) {
                        EditText et = (EditText) findViewById(R.id.editText1);
                        String editText_input = et.getText().toString();
                        String USSD_code = "tel:" + "*712*" + editText_input + "#";
                        String encodedHash = Uri.encode("#");
                        USSD_code = USSD_code.replace("#", encodedHash);
                        Intent callIntent = new Intent(Intent.ACTION_CALL, Uri.parse(USSD_code)); //must add permission in AndroidManifest.xml : <uses-permission android:name="android.permission.CALL_PHONE"></uses-permission>
                        startActivity(callIntent);
                    }
                });
        }

}

توضیحاتی در مورد کدهای Activity :

قبلا شماره گیری را در آموزش شماره 2637 شرح داده بودیم. فقط یک نکته مهم وجود دارد و آن این است که اگر علامت # را به صورت ساده در شماره ذکر کنیم، این علامت، شماره گیری نخواهد شد. بنابراین باید Uri.encode را برای آن به کار ببریم. یعنی به صورت زیر :

بعد رشته encodedHash را به جای علامت # در رشته (String) مربوط به تعریف شماره، قرار می دهیم (جایگزین می کنیم). برای این منظور، از روش replace استفاده می کنیم. بنابراین کد USSD به صورت زیر تعریف می شود :

همان طور که در آموزش شماره 2637 تذکر داده ایم، برای شماره گیری، باید اجازه دسترسی زیر در فایل AndroidManifest.xml از پروژه اندروید ذکر شود :

با اجرای برنامه اندروید، اگر بر روی دکمه اول اشاره کنیم، کد USSD اصلی ارا شده و صفحه زیر را مشاهده می کنیم :

زیرا کد USSD زیر اجرا شده است :

اما چنانچه در EditText ، عدد 1 را وارد کرده و بعد بر روی دکمه دوم اشاره کنیم، صفحه زیر را مشاهده می کنیم :

زیرا کد USSD زیر اجرا شده است :

نکته

اگر برنامه اندرویدی برای پرداخت وجه توسط کد USSD بسازیم (یا هر نوع فرآیند دیگر که نیاز به دریافت تایید انجام فرآیند داشته باشیم)، باید به شکلی متوجه شویم که آیا کاربر فرآیند پرداخت وجه را با موفقیت طی کرده است یا نه. این موارد، بستگی به ساختارهای کدنویسی که بانک در اختیار ما قرار می دهد دارد و بنابراین توصیه می کنم که به راهنمای خود بانک ها و شرکت های مورد نظرتان مراجعه نمایید.

دسته بندی مباحث عمومی، در برنامه نویسی اندروید

نویسنده علیرضا گلمکانی

شماره کلید 3019

گزینه ها

به اشتراک گذاری (Share) در شبکه های اجتماعی

FaceBook Twitter Digg Reddit LinkedIn Pinterest StumbleUpon

نظرات 5 2 3

علیرضا

۱۳۹۵/۰۹/۰۷

۰۰:۱۱

دمتون گرم خیلی آموزش مفیدی بود......
اجرتون با خدا

مهدی

۱۳۹۵/۰۹/۱۶

۲۱:۴۱

سلام
با تشکر
لطفا بفرمایید در مراجلی از ussd که محتوا را از ورودی می گیرد مانند شماره حساب
رشته به چه صورت باید پاس شود؟
مثلا رشته ای که بتوانیم کد ussd حواله به حساب فلان شماره و مبلغ خاصی را قرار بدهیم؟

ارسال نظر جدید (بدون نیاز به عضو بودن در وب سایت)