در این آموزش  میتوانید در کمتر 5 دقیقه برنامه های اندروید خود را به سرویس پرداخت درون برنامه ای همراه پی مجهز نمایید.

محیط برنامه نویسی : Eclipse

1- در ابتدا فایل کتابخانه همراه پی را دانلود نمایید (دانلود)

فایل را از حالت فشرده خارج نمایید .

محتویات داخل فایل :

  1. Hamrahpay.java : فایل اصلی کتابخانه همراه پی که با وب سرویس همراه پی ارتباط برقرار میکند
  2. PayActivity.java : فایل اکتیوی صفحه پرداخت
  3. pay_activity.xml : فایل layout رابط کاربری صفحه پرداخت
  4. MainActivity.java :  کد دکمه پرداخت در این فایل قرار دارد (خط 23 تا 95)

آموزش استفاده از کتابخانه همراه پی

مرحله اول

فایل pay_activity.xml را به پوشه layouts پروژه خود اضافه نمایید 



مرحله دوم

بر روی پروژه خود راست کلیک نموده و بر روی گزینه Refresh کلیک کنید  تا id فایل xml به پروژه اضافه گردد



مرحله سوم :

فایل های HamrayPay.java و PayActivity.java  را به پروژه خود اضافه نموده و خط اول آنها را با نام پکیج برنامه خودتان جایگزین نمایید.




مرحله 4

فایل AndroidManifest.xml  پروژه خود باز کرده و Permision ها و activity های برنامه را به آنها اضافه نمایید
این پرمیژن ها  را میتوانید از فایل AndroidManifest.xml که همراه کتابخانه همراه پی آمده است کپی نمایید.



تصویر فایل AndroidManifest.xml
مرحله آخر :
اضافه کردن دکمه پرداخت به برنامه : 
در هر کجا از برنامه خود میتوانید یک دکمه برای پرداخت اضافه نمایید . ما به پروژه خود یک دکمه با id ی pay_btn اضافه کرده ایم و بر روی رویداد setOnClickListener کد های نمایش صفحه پرداخت را نوشته ایم :
لایبراری های زیر را به اکتیویتی که دکمه پرداخت دارد اضافه نمایید : 
import android.view.View;
import android.widget.Toast;
import android.content.Intent;
import java.util.concurrent.ExecutionException;

کد های مربوط به دکمه پرداخت در فایل MainActivity.java خط های 23 تا 95 آن را در پروژه خود کپی نموده و در خط 39  همین فایل برنامه به جای کلمه "hp_54ed96124dcb0460550163" شناسه کالای خود را که در همراه پی ثبت نموده اید جایگزین نمایید.

در خط 56 فایل MainActivity.java و خط 83 فایل PayActivity.java باید کد های مربوط به ارتقاع نرم افزار خود را بنویسید . به عنوان مثال اگر قرار است سکه ای به بازی اضافه شود یا فصل های یک کتاب فعال گردند و یا برنامه شما به نسخه طلایی ارتقاع پیدا کند باید کد های مربوط به آن در این دو فایل در محل های مشخص شده نوشته شوند.

هم اکنون در 5 مرحله بسیار ساده نرم افزار شما به سرویس پرداخت درون برنامه ای همراه پی مجهز شده است.
در صورت هرگونه سوالی میتوانید با افتتاح یک تیکت جدید سوالات خود را با ما در میان بگذارید.

منبع : همراه پی

به منظور Sign کردن برنامه های خود برای انتشار در گوگل پلی مراحل زیر را طی نمایید

محیط برنامه نویسی : Android Studio


1- از منو ها گزینه  Build > Generate Signed APK را انتخاب نمایید

2- در صفحه باز شده بر روی  Create new کلیک نمایید تا کلید جدید تولید شود (در صورتی که قبلا یک کلید تولید کرده اید به مرحله 4 بروید)

3- در صفحه New Key Store  اطلاعات لازم را تکمیل نمایید (شکل شماره 1)



شکل شماره 1


4- در صفحه Generate Signed APK Wizard کلید خود را انتخاب کرده و رمز عبور آنها را وارد نمایید



شکل شماره 2


5- در صفحه بعد مسیر ذخیره فایل Apk را مشخص نمایید تا به صورت Sign شده ذخیره گردد.



شکل شماره 3

به منظور Sign کردن برنامه های خود برای انتشار در گوگل پلی مراحل زیر را طی نمایید

محیط برنامه نویسی : Eclipse


1- در محیط Eclipse بر روی پروژه خود راست کلیک نموده و گزینه File > Export. کلیک نمایید.

2- در صفحه Export بر روی کزینه Export Android Application را انتخاب نموده و بر روی Next کلیک نمایید.

3- در صفحه Export Android Application پروژه ای که میخواهید Sign شود را انتخاب نمایید.

4- در صفحه بعد محلی را که میخواهید keystore  ذخیره گردد به همراه رمز عبور keystore  را انتخاب نمایید. در صورتی که قبلا keystore را دارید میتوانید گزینه Use existing keystore را انتخاب نموده و رمز عبور آن را وارد نماید و به مرحله 6 بروید 


شکل شماره 1


5- در صفحه بعد اطلاعات لازم را وارد نمایید


شکل شماره 2


6- در این مرحله محلی برای ذخیره فایل sign شده برنامه خود انتخاب نمایید


شکل شماره 3


منبع : همراه پی



در این آموزش میتوانید در کمتر از 5 دقیقه نرم افزار های خود را به سرویس پرداخت درون برنامه ای همراه پی مجهز نمایید

محیط برنامه نویسی : Basic4Android

موارد مورد نیاز :

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

فایل را از حالت فشرده خارج نمایید.

محتویات فایل : 



  • از دایرکتوری libs فایل WebViewExtras2-v2.10 از حالت فشرده خارج نموده و فایل های آن را در مسیر نصب Basic4Android در زیر دایرکتوری Libraries کپی نمایید.
  •  دایرکتوری hamrahpay_b4a_v1beta شامل نمونه پروژه همراه پی برای Basic4Android میباشد که شما باید این پروژه را در محیط Basic4Android باز نمایید.


شروع آموزش استفاده از همراه پی در Basic4Android


1- ابتدا یک پروژه جدید در b4a ایجاد نمایید و طبق تصویر زیر کتابخانه های مورد نیاز را فعال نمایید:



2- اضافه کردن ماژول همراه پی : در این مرحله باید یک ماژول جدید به نام hamrahpay ایجاد نمایید . طبق تصویر زیر :


سپس نام آن را hamrahpay گذاشته 


و کد های داخل ماژول hamrahpay که در نمونه کد های دانلود شده قرار دارد را در این فایل کپی نمایید.


3- ایجاد یک اکتیویتی جدید به نام payment_activity طبق تصویر زیر : 



در این مرحله نیز باید همانند مرحله قبل کد های payment_activity را از نمونه کدهای دانلود شده کپی نمایید و در این فایل قرار دهید.


3- حال نوبت به ساخت دکمه پرداخت رسیده است . برای این کار شما باید یک دکمه در پروژه خود ایجاد نموده و در رویداد click آن کد درخواست پرداخت را بنویسید . این کار به سادگی هرچه تمام و تنها با 2 خط کد انجام میشود . در تصویر زیر نمونه کد پرداخت را مشاهده مینمایید که در نمونه کد پروژه نیز وجود دارد.



در خط اول ابتدا صحت اتصال به اینترنت توسط کتابخانه همراه پی چک میشود و در صورت عدم اتصال پیام خطایی به کاربر نمایش داده میشود و در غیر اینصورت یک درخواست پرداخت ارسال خواهد شد و در صورتی که مشکلی وجود نداشته باشد صفحه پرداخت به کاربر نمایش داده خواهد شد . در این کد product_sku یک متغیر از نوع string میباشد که حاوی کد شناسه کالا میباشد . این کد را میتوانید پس از ثبت کالا در همراه پی از پنل خود کپی نمایید.

این دکمه در هرکجای نرم افزار شما میتواند قرار گیرد ، ما در این پروژه در اکتیویتی Main قرار داده ایم در صورتي كه شما در اكتيويتي ديگري قرارداديد لطفا نام اكتیويتي مورد نظر را دردوخط زير در كدماژول همراه پي تغيير دهيد .
HttpUtils.Initialize("Pay_Request",Main)
----
HttpUtils.Initialize("Pay_Verify",Main)


برای ایجاد دکمه پرداخت میتوانید از Designer وارد محیط طراحی شده و از منوی Add View و انتخاب Button یک دکمه به نام pay_btn ایجاد نمایید . طبق تصویر زیر : 



سپس کدهای درخواست پرداخت را همانند شکل قبل از پروژه کپی نموده و در رویداد click آن قرار دهید .

نکته : این دکمه در هرکجای نرم افزار شما میتواند قرار گیرد ، ما در این پروژه در اکتیویتی Main قرار داده ایم که میتوانید از نمونه کدهای دانلود شده مشاهده نمایید .

در اکتیویتی Main یک متغیر به نام product_sku از نوع String قرار دارد که حاوی کد شناسه محصول میباشد و باید با شناسه محصول شما جایگزین گردد.


مرحله نهایی : 

فعال سازی نرم افزار شما پس از پرداخت ، این فعال سازی میتواند شامل ارائه هر نوع سرویسی در نرم افزار شما باشد که پس از پرداخت باید انجام گردد . به عنوان مثال بازگشایی قسمت های قفل شده نرم افزار شما یا اضافه کردن سکه و امتیاز به برنامه و ...

برای این کار فایل ماژول hamrahpay را باز کرده و در خط آخر یک متد یا sub به نام activate_app وجود دارد که باید کدهای فعال سازی برنامه خود را در آن بنویسید و یا در صورتی که تابع فعال سازی دیگری دارید در این تابع فراخوانی گردد . 

هم اکنون در 4 مرحله بسیار ساده نرم افزار شما به سرویس پرداخت درون برنامه ای همراه پی مجهز شده است.

در صورت هرگونه سوالی میتوانید با افتتاح یک تیکت جدید سوالات خود را با ما در میان بگذارید.


منبع : همراه پی


تغییرات این نسخه


  1. آسان شدن روند پرداخت درون برنامه ای و استفاده فقط 1 خط کد نویسی
  2. پرداخت به ازای هر دستگاه (برای هر نصب باید مبلغ پرداخت شود)
  3. پرداخت به ازای ایمیل ( همانند گوگل پلی به ازای هر خرید میتوان روی 2 دستگاه نصب کرد )
  4. امکان فروش چندین کالا در یک برنامه به سادگی
  5. عدم دریافت ایمیل هنگان خرید از مشتریان
  6. رفع اشکالات جزئی
  7. دانلود کتابخانه


ابتدا وارد این صفحه شوید. و آخرین ورژن سورس کد را دانلود نمایید.


مستندات


در ابتدا فایل دانلود شده را از حالت فشرده خارج کنید در محیط اندروید استودیو از منوی File -> new -> Import Module را انتخاب نمایید. در صفحه باز شده مسیر سورس کد همراه پی را انتخاب نمایید و در بخش Module name نام :hamrahpay را وارد نمایید.



در فایل build.gradle مربوط به app کد زیر را وارد نمایید در بخش dependencies


   

compile project(':hamrahpay')



در مرحله آخر در هر کلاسی که میخواهید دکمه پرداخت را قرار دهید کد زیر را وارد نمایید


   

import ir.devage.hamrahpay.Hamrahpay;


با این کتابخانه را به آن کلاس اضافه کرده اید و حال در کد کلیک هر دکمه ای برای پرداخت در نظر گرفته اید میتوانید کد زیر را وارید نمایید


    Hamrahpay.Pay(MainActivity.this,"شناسه کالا");


توجه:


MainActivity.this را با نام اکتویتی خود جایگزین نمایید

شناسه کالا همان شناسه ای است که در پنل همراه پی در بخش کالا ها دریافت مینمایید . مثلا :‌hp_5416d2e3a5f75560925755


 توابع کتابخانه همراه پی


چک کردن وضعیت پرداخت


> Hamrahpay.isPremium(getApplicationContext(),"شناسه کالا")

شرح :‌این تابع چک میکند که آیا یک کالایی در نرم افزار شما خریداری شده است یا خیر


نوع بازگشتی :‌boolean


ورودی ها :‌


context

sku : شناسه کالا از نوع String مثال :‌

if (Hamrahpay.isPremium(getBaseContext(),"hp_.."))

{

    //---------

}

تابع پرداخت


>  Hamrahpay.Pay(MainActivity.this,sku);

شرح :‌ برای پرداخت استفاده میشود . هنگامی که این تابع فراخوانی میگردد صفحه پرداخت نمایش داده میشود .


ورودی ها :‌


context از نوع Activity

شناسه کالا از نوع String

به مخض فراخوانی این تابع صفحه پرداخت نمایش داده میشود .


 پیکربندی نوع پرداخت


دو نوع پرداخت در همراه پی پشتیبانی میگردد


پرداخت به ازای هر دستگاه :‌با این نوع پرداخت هر فردی که نرم افزار را خریداری میکند فقط بر روی همان دستگاهی که خریداری کرده است میتواند از نرم افزار استفاده نماید و پرداخت برای همان دستگاه قابل شناسایی میباشد.

پرداخت به ازای ایمیل :‌ در این نوع پرداخت مکانیزمی طراحی شده است که هر فردی که نرم افزار را خریداری میکند بتواند بر روی گوشی دیگری هم نصب کنم . به طور مثال با یک بار نرم افزار شما را روی گوشی و تبلت خود نصب نماید. این روش توسط گوگل پلی و دیگر مارکت ها استفاده میگردد.

برای انتخاب نوع پرداخت در ماژول همراه پی فایل strings.xml را باز کرده و مقدار verification_type را تغییر دهید

‍‍‍‍

به جای type میتوانید از email_verification یا device_verification استفاده نمایید.




پشتیبانی

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

در این آموزش میتوانید در کمتر از 5 دقیقه نرم افزار های خود را به سرویس پرداخت درون برنامه ای همراه پی مجهز نمایید

محیط برنامه نویسی : Basic4ios 

موارد مورد نیاز :

دانلود نمونه سورس همراه پی : دانلود 

فایل را از حالت فشرده خارج نمایید.

محتویات فایل : 



  1. دایرکتوری  Module فایل هایی که باید در پروژه ی خود import کنید قرار دارند
  2. دایرکتوری HamrahPay B4i شامل نمونه پروژه همراه پی برای Basic4ios میباشد 
  3. دایرکتوری UI شامل فایل مربوط به رابط گرافیکی محیط پرداخت می باشد
شروع آموزش استفاده از پرداخت درون برنامه ای همراه پی برای Basic4iOS

1- ابتدا یک پروژه جدید در b4i ایجاد نمایید و طبق تصویر زیر کتابخانه های مورد نیاز را فعال نمایید:


2-اضافه کردن ماژول های مورد نیاز : در این مرحله باید ماژول هایی را که دانلود کرده و در دایرکتوری Module قرار دارند به برنامه اضافه کنید طبق تصویر زیر



3- سپس برای اضافه کردن رابط گرافیکی محیط پرداخت باید فایل payview.bil را که در دایرکتوری UI قرار دارد به برنامه اضافه کنید برای این مار مانند تصویر زیر وارد Designer  شده و از منوی file گزینه Open را انتخاب نمونده و فایل payview.bil را به Designer  اضافه می کنید.



4- حال نوبت به ساخت دکمه پرداخت رسیده است . برای این کار شما باید یک دکمه در پروژه خود ایجاد نموده و در رویداد click آن کد درخواست پرداخت را بنویسید . این کار به سادگی هرچه تمام و تنها با 1 خط کد انجام میشود . در تصویر زیر نمونه کد پرداخت را مشاهده مینمایید که در نمونه کد پروژه نیز وجود دارد.

در ابتدا صحت اتصال به اینترنت توسط کتابخانه همراه پی چک میشود و در صورت عدم اتصال پیام خطایی به کاربر نمایش داده میشود و در غیر اینصورت یک درخواست پرداخت ارسال خواهد شد و در صورتی که مشکلی وجود نداشته باشد صفحه پرداخت به کاربر نمایش داده خواهد شد . در این کد product_sku  یک متغیر از نوع string میباشد که حاوی کد شناسه کالا میباشد . این کد را میتوانید پس از ثبت کالا در همراه پی از پنل خود کپی نمایید.

این دکمه در هرکجای نرم افزار شما میتواند قرار گیرد ، ما در این پروژه در mainpage قرار داده ایم 
برای ایجاد دکمه پرداخت میتوانید از Designer وارد محیط طراحی شده و از منوی Add View و انتخاب Button یک دکمه به نام  ButtonPay ایجاد نمایید . طبق تصویر زیر : 


سپس کدهای درخواست پرداخت را همانند شکل قبل از پروژه کپی نموده و در رویداد click آن قرار دهید .
نکته : این دکمه در هرکجای نرم افزار شما میتواند قرار گیرد 
در ماژول  HamrahPay که در  قسمت 2 به برنامه اضافه کردید یک متغیر به نام product_sku از نوع String قرار دارد که حاوی کد شناسه محصول میباشد و باید با شناسه محصول شما جایگزین گردد. 
نکته: شناسه محصول خود را باید از پنل کاربری خود در سایت همراه پی دریافت نمایید


مرحله نهایی : 
فعال سازی نرم افزار شما پس از پرداخت ، این فعال سازی میتواند شامل ارائه هر نوع سرویسی در نرم افزار شما باشد که پس از پرداخت باید انجام گردد . به عنوان مثال بازگشایی قسمت های قفل شده نرم افزار شما یا اضافه کردن سکه و امتیاز به برنامه و ...
برای این کار فایل ماژول hamrahpay را باز کرده و در خط آخر یک متد یا sub به نام activate_app وجود دارد که باید کدهای فعال سازی برنامه خود را در آن بنویسید و یا در صورتی که تابع فعال سازی دیگری دارید در این تابع فراخوانی گردد . 

هم اکنون در 4 مرحله بسیار ساده نرم افزار شما به سرویس پرداخت درون برنامه ای همراه پی مجهز شده است.
در صورت هرگونه سوالی میتوانید با افتتاح یک تیکت جدید سوالات خود را با ما در میان بگذارید.