Skip to content

استفاده از پرداخت در ماژولها

Mostafa Barmshory edited this page Jun 25, 2017 · 1 revision

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

ایجاد یک پرداخت

اولین و ساده ترین راه ایجاد یک پرداخت ایجاد یک پرداخت عمومی است. برای این کار به صورت زیر عمل می شود:

    Bank_Service::create(array(
            'amount' => 1000,
            'title' => 'payment title',
            'description' => 'description',
            'email' => '[email protected]',
            'phone' => '0917222222',
            'callbackURL' => 'http://calback',
            'backend' => $backend
    ));

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

amount

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

title

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

description

توضیحاتی در مورد پرداخت تعیین می‌کند این توضیحات به بانک و یا سایر بخشهای سیستم داده می‌شود

email

این مقدار اختیاری است و تعیین کننده ایمیل فردی است که باید پرداخت را انجام دهد

phone

شماره تماس فردی را تعیین می‌کند که می‌خواد پرداخت را انجام دهد

callbackURL

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

backend

بانکی را تعیین می‌کند که پرداخت باید با ان انجام شود.

ایجاد پرداخت برای یک موجودیت

فرض کنید که می‌خواهید پرداختی را در سیستم ایجاد کنید که در رابطه با یک موجودیت خاص (مثلا کاربر) است. در این حالت می‌توانید از فراخوانی زیر برای ایجاد پرداخت استفاده کنید:

    Bank_Service::create(array(
            'amount' => 1000,
            'title' => 'payment title',
            'description' => 'description',
            'email' => '[email protected]',
            'phone' => '0917222222',
            'callbackURL' => 'http://calback',
            'backend' => $backend
    ), $object);

ایجاد پرداخت برای کلاس و شناسه

زمانی که می‌خواهید یک پرداخت برای موجودیتی مجازی ایجاد کنید به صورت زیر عمل کنید:

    Bank_Service::create(array(
            'amount' => 1000,
            'title' => 'payment title',
            'description' => 'description',
            'email' => '[email protected]',
            'phone' => '0917222222',
            'callbackURL' => 'http://calback',
            'backend' => $backend
    ), $className, $classId);

به این ترتیب می‌توانید پرداخت را برای مراحل بعد بدون ذخیره کردن شناسه آن بازیابی و بررسی کنید.