.:: اتصال ماژول اکشن فرم به درگاه بانک سامان ::.

جهت خرید و مشاهده توضیحات کامل ماژول درگاه سامان کیش به لینک مراجعه کنید. جزئیات ماژول درگاه سامان کیش

آموزش راه اندازی ماژول :

با سطح دسترسی مدیر ارشد وارد بخش میزبان > افزونه ها > نصب افزونه جدید  شوید و ماژول اکشن فرم را انتخاب و نصب کنید و به دنبال آن افزونه DnnPlus.Saman_02.00.00_Install.zip را نصب کنید تا اکشن جدیدی به اسم DnnPlusSaman  به لیست اکشن های ماژول اکشن فرم اضافه شود.بعد از اتمام نصب از بخش افزودن ماژول جدید ، ماژول اکشن فرم را کشیده و در صفحه دلخواهی رها کنید و در ادامه :

نکته : بعد از نصب اکشن درگاه سامان ، یک قالب فرم آماده به لیست قالب های اکشن فرم اضافه میشه که به راحتی با کلیک یک فرم آماده درست شده و میتوانید روش انجام کار را به صورت کامل مشاهده کنید.

.:: مرحله اول : هدایت کاربر به درگاه بانک سامان ::.

1. وارد بخش مدیریت ماژول اکشن فرم شوید و فیلدهای لازم را اضافه کنید ( یک فیلد مخفی با شناسه txtStatus نیز برای ذخیره نتیجه تراکنش هنگام برگشت از درگاه ایجاد کنید)
2. دکمه ثبت به فرم اضافه کنید و به قسمت On Click Handler دکمه رفته و اکشن های زیر را به ترتیب اضافه کنید : 

   الف) اکشن Start Saman paying <  DnnPlusSaman  را اضافه کنید و فیلدهای لازم را پر کنید.

     ب) اکشن Message > Display Message  را اضافه کنید و توکن [PostForm] را در آن قرار دهید.

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

.:: مرحله دوم : انجام تراکنش و برگشت از درگاه بانک سامان ::.

 در بخش On Init  اکشن فرم به ترتیب 2 اکشن زیر را اضافه کنید:

1. اکشن DnnPlusSaman > Start Saman CallBack را اضافه کنید (شماره فاکتور که از درگاه به صفحه کال بک ارسال می شود تبدیل به توکن میشود و میتوانید با روش دلخواه بررسی کنید چنین فاکتوری صادر شده است یا خیر)
2. اکشن DnnPlusSaman > Payment processing  را اضافه کنید و فیلدهای مربوطه را پر نمایید(مانند مثال زیر پر نمایید) :

• User Name : نام کاربری
• Password : کلمه ی عبور
• Order Id : شماره فاکتور ، برای بررسی با شماره فاکتور ارسال شده از درگاه بانک
• Price : مبلغ فاکتور ، برای بررسی با مبلغ پرداختی توسط کاربر
• On Successful : لیست اکشن هایی که هنگام پرداخت موفقیت آمیز می خواهید اجرا شوند

  1. اکشن Context > Inject Form Data  را اضافه کنید روی دکمه Add Form Data  کلیک کنید و مقدار Name  را برابر txtStatus و مقدار Value  را برابر [SamanMessage] قرار دهید.
  2. اکشن Data > Save Report in the Database  را اضافه کنید .
  3. اکشن Message > Display Message را اضافه کنید و از توکن های ([MID] [Error] و[TRACENO] و[Successful] و[StateCode] و[State] و[SecurePan] و[RRN] و [ResNum] و [RefNum] و [MID] و [SamanMessage] و [CID] و [Amount] و [IsCallBack] ) نیز می توانید در متن پیام استفاده کنید.

• On Canceled : لیست اکشن هایی که هنگام لغو پرداخت می خواهید اجرا شوند.
• On Invalid : لیست اکشن هایی که هنگام نامعتبر بودن پرداخت می خواهید اجرا شوند.
• On Error : لیست اکشن هایی که هنگام وجود خطا در کدها می خواهید اجرا شوند.

ویرایش شد بوسیله کاربر 1396/07/03 00:18:58 ق.ظ  | دلیل ویرایش: اصلاحات نگارشی