sobhansgh/mellat-api

HiveWeb Mellat payment gateway for API-first Laravel apps (JSON-only).

Maintainers

Package info

github.com/sobhansgh/mellat-api

pkg:composer/sobhansgh/mellat-api

Statistics

Installs: 3

Dependents: 0

Suggesters: 0

Stars: 1

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

1.0.0 2025-08-26 09:08 UTC

Requires

MIT 92460157a6b143b37b8e866e4a18946de3107de5

This package is auto-updated.

Last update: 2026-03-26 10:51:15 UTC

README

پکیج درگاه بانک ملت مخصوص API-first (لاراول) — خروجی فقط JSON (بدون Blade / فرم). نویسنده: Sobhan Ghasemi — برند: HiveWeb

نصب

composer require sobhansgh/mellat-api
php artisan vendor:publish --tag=hiveweb-mellat-api-config
php artisan vendor:publish --tag=hiveweb-mellat-api-migrations
php artisan migrate

.env

MELLAT_API_TERMINAL_ID=xxxx
MELLAT_API_USERNAME=xxxx
MELLAT_API_PASSWORD=xxxx
MELLAT_API_WSDL=https://bpm.shaparak.ir/pgwchannel/services/pgw?wsdl
MELLAT_API_CALLBACK_URL=/api/payments/mellat-api/callback
MELLAT_API_CONVERT_TO_RIAL=true

اندپوینت‌ها (پیش‌فرض)

  • POST /api/payments/mellat-api/pay → { amount: 120000, order_id?: "...", additional?: "..." } → خروجی: { ok, ref_id, redirect_url, order_id }
  • بانک به /api/payments/mellat-api/callback برمی‌گردد (GET/POST)
  • سپس کلاینت شما POST /api/payments/mellat-api/verify را با order_id, sale_order_id, sale_reference_id می‌زند.

مسیرها، پیشوند و میدلور قابل تغییر از طریق فایل کانفیگ config/hiveweb-mellat-api.php هستند.

نکات هم‌زیستی با نسخه‌ی Web

  • کلیدهای ENV با پیشوند MELLAT_API_* هستند.
  • فایل کانفیگ: config/hiveweb-mellat-api.php (کلید کانفیگ: hiveweb-mellat-api).
  • جدول دیتابیس: mellat_api_logs (عدم تداخل با هر جدول دیگری مثل mellat_logs).

License

MIT