Download the PHP package rmscms/payment without Composer

On this page you can find all versions of the php package rmscms/payment. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of rmscms/payment

Informations about the package payment

RMS Payment

پکیج rmscms/payment یک لایه‌ی ماژولار برای مدیریت درگاه‌های بانکی در اکوسیستم RMS است. هدف این لایه، جداسازی منطق پیچیده‌ی پرداخت از پروژه‌های مختلف (Shop، Core و …) و فراهم کردن یک API یکپارچه برای «شروع تراکنش» و «تأیید نهایی» است.

امکانات فعلی

نصب

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

این دستور کانفیگ را پابلیش می‌کند، مایگریشن‌های پکیج را اجرا می‌کند، درایور پیش‌فرض را نصب/همگام‌سازی می‌کند و منوی پرداخت را به سایدبار ادمین اضافه می‌کند. در صورت نیاز می‌توانید درایور مشخصی را نصب کنید:

یا اگر در محیط Monorepo هستید:

  1. فولدر را در packages/rms/payment قرار دهید.

  2. در composer.json ریشه مسیر آن را به لیست repositories اضافه کنید:

  3. Autoload پروژه را به‌روزرسانی کنید:

  4. composer dump-autoload

آماده‌سازی Playground سندباکس (پروژه‌ی rms2-packages)

  1. پس از نصب، فایل کانفیگ را منتشر کنید:

  2. مایگریشن‌های هسته را اجرا کنید:

  3. برای هر Driver که مسیر Migration دارد، دستور اختصاصی‌اش را بزنید (مثلاً زرین‌پال):

  4. در .env مقدارهای زیر را ست کنید تا به سندباکس زرین‌پال متصل شوید:

  5. حالا می‌توانید از مسیر http://localhost:8000/payment/sandbox فرم تست را باز کنید. این صفحه:
    • فرم ساخت تراکنش تستی با مبلغ دلخواه دارد.
    • امکان انتخاب Driver (بر اساس PAYMENT_GATEWAY) را فراهم می‌کند؛ برای تست آفلاین، مقدار .env را روی sandbox بگذارید.
    • بعد از Start، به درگاه تستی داخلی (/payment/sandbox/gateway) هدایت می‌شوید و می‌توانید سناریوی موفق/ناموفق را انتخاب کنید.
    • هر تراکنش در جدول payment_transactions با وضعیت و پیام دقیق (status_detail) لاگ می‌شود و در لیست پایین صفحه قابل مشاهده است.
    • Callback روی آدرس payment/sandbox/callback فراخوانی می‌شود و خروجی Payment::verify() به‌صورت کامل نمایش داده می‌شود.

تنظیمات

فایل پیکربندی در config/payment.php منتشر می‌شود. مهم‌ترین کلیدها:

پنل مدیریت درگاه‌ها و تراکنش‌ها

نحوه استفاده

در مرحله‌ی بازگشت از بانک:

توسعه‌ی درگاه جدید

  1. یک کلاس جدید بسازید که RMS\Payment\Contracts\Gateway را پیاده‌سازی کند.

  2. آن را در config/payment.php ثبت کنید:

  3. (اختیاری) برای حالت دو مرحله‌ای می‌توانید متد verify را به گونه‌ای بنویسید که هم توکن اولیه و هم نتیجه‌ی callback را بررسی کند.
  4. اگر بانک نیاز به ذخیره‌ی کد رهگیری یا فیلدهای اختصاصی دارد، داخل Migration پروژه‌ی مصرف‌کننده جدول payment_transactions (یا مشابه) ایجاد کنید و reference_id, transaction_id, card_mask و سایر متادیتا را ذخیره نمایید.
  5. برای بانک‌هایی که RSA 2048 یا گواهی اختصاصی می‌خواهند، فایل‌های .key و .cer را داخل مسیری که در certificates_path مشخص شده قرار دهید و داخل Driver خودتان از همان مسیر بخوانید.

نصب Driverها

اگر در کانفیگ هر Driver مسیری برای Migration تعریف کنید، با دستور زیر می‌توانید آنها را اجرا کنید:

دستور بالا ابتدا مایگریشن‌های پایه‌ی پکیج را اجرا می‌کند، سپس اگر درایور مسیر اختصاصی داشته باشد آن را نیز migrate می‌کند و در نهایت رکورد مربوط به درگاه را در جدول payment_drivers به‌روز/ایجاد می‌کند. اگر درایوری Migration نداشته باشد، فقط مرحله‌ی همگام‌سازی انجام می‌شود.

وضعیت‌های ذخیره‌شده در جدول payment_transactions

درایور زرین‌پال این وضعیت‌ها را به صورت خودکار به‌روزرسانی می‌کند و Message خطا را بر اساس کدهای رسمی زرین‌پال نگه می‌دارد. در صورت نوشتن درایور جدید کافی است از متدهای PaymentTransaction (markSent, markReturned, markSuccess, markFailed) استفاده کنید تا همهٔ بانک‌ها گزارش یکپارچه داشته باشند.

نقشه‌ی راه

با این ساختار، اتصال هر بانک جدید صرفاً پیاده‌سازی یک کلاس است و پروژه‌ی اصلی فقط با PaymentClient تعامل خواهد داشت.

یکپارچه‌سازی در پنل ادمین

????? ???? ???? ??? ????? (shop-test)

???? ?????? ????? ?????? ????? ???? ??? ?? ????? ???? ???????? ?? ??????? shop-test ??????? ??? ?? ???? ????:

`

1) ????? ???? ?????? ???? API ? ????? Blade

cd C:\laragon\www\rms2-packages\shop-test php artisan serve --port=8000

2) ????? ??????? ???? ??????? public ? ????? /shop/*

php -S 127.0.0.1:8001 -t public

3) (???????) Vite dev server ???? ?????????? ?????

npm run dev -- --host 127.0.0.1 --port 5173 `

All versions of payment with dependencies

PHP Build Version
Package Version
Requires php Version ^8.2
illuminate/support Version ^11.0|^12.0
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package rmscms/payment contains the following files

Loading the files please wait ...