پکیج لاراول شی‌پی
پکیج لاراول شی‌پی کلاینت PHP را با یک Facade در دسترس می‌گذارد، تنظیمات را از .env می‌خواند و مسیر وب‌هوک را با بررسی امضای HMAC ثبت می‌کند. پرداخت‌های تأییدشده، ناموفق و همهٔ رویدادها به‌شکل رویداد لاراول (PaymentVerified، PaymentFailed، WebhookReceived) به برنامهٔ شما می‌رسند. دستور php artisan sheypay:test کلید و اتصال را بررسی می‌کند.
- رویدادهای برنامه
- وب‌هوک امضاشده
- استرداد از داخل پنل
- وضعیت «در انتظار» درست
- تومان و ریال
- حالت آزمایشی با sk_test_
- دکمهٔ تست اتصال
این نسخه بتا است: کامل است ولی هنوز روی فروشگاه‌های واقعی کافی اجرا نشده. اول روی نسخهٔ آزمایشی سایتتان و با کلید sk_test_ امتحانش کنید و هر اشکالی دیدید به پشتیبانی بگویید.
نصب
- ۱
با Composer نصب کنید: composer require
sheypay/laravel.تا پیش از انتشار روی Packagist، zip را درpackages/sheypay-laravelباز کنید و آن را به‌شکل path repository اضافه کنید. - ۲
در .env مقدارهای SHEYPAY_KEY (برای آزمایش
sk_test_)، SHEYPAY_WEBHOOK_SECRET و SHEYPAY_CURRENCY را بگذارید. - ۳
php artisan sheypay:test را اجرا کنید تا کلید و دامنهٔ درگاه را ببینید.
- ۴
در پنل شی‌پی › وب‌هوک‌ها آدرس
https://سایت-شما/sheypay/webhookرا ثبت کنید. - ۵
برای رویداد PaymentVerified یک listener بنویسید که سفارش را با merchant_reference پیدا و پس از مقایسهٔ مبلغ، پرداخت‌شده کند.
- کلاینت PHP شی‌پی هنگام ساخت بسته در
lib/SheyPay.phpقرار می‌گیرد. - تا پیش از انتشار روی Packagist، از فایل zip و path repository نصب کنید.
تنظیمات
- SHEYPAY_KEY
- کلید API؛
sk_test_برای آزمایش وsk_live_برای فروش واقعی. - SHEYPAY_WEBHOOK_SECRET
- رمز امضای endpoint وب‌هوک از پنل شی‌پی.
- SHEYPAY_WEBHOOK_PATH
- مسیر وب‌هوک (پیش‌فرض
sheypay/webhook). خالی بگذارید تا مسیر ثبت نشود. - SHEYPAY_CURRENCY
- واحد مبالغی که به Amount::toRial می‌دهید: IRT یا IRR.
تست در محیط آزمایشی
با کلید sk_test_ پول واقعی جابه‌جا نمی‌شود و در صفحهٔ بانک آزمایشی نتیجه را خودتان انتخاب می‌کنید.
- با کلید
sk_test_یک پرداخت بسازید و در بانک آزمایشی نتیجه را انتخاب کنید. - در آدرس بازگشت SheyPay::confirm را صدا بزنید و هر سه نتیجه را امتحان کنید.
- از پنل شی‌پی رویداد آزمایشی وب‌هوک بفرستید و در لاگ لاراول رویداد WebhookReceived را ببینید.
مشکلات رایج
وب‌هوک خطای ۴۱۹ می‌دهد.
مسیر را دستی داخل گروه web ثبت نکنید؛ مسیر خود پکیج بدون CSRF است.
وب‌هوک خطای ۵۰۳ می‌دهد.
SHEYPAY_WEBHOOK_SECRET خالی است. مقدار را بگذارید و php artisan config:clear بزنید.
Class "SheyPay\Client" not found
پس از نصب از مسیر محلی composer dump-autoload بزنید.
تغییرات
نسخهٔ ۱.۰.۰
- نسخهٔ اول: Facade، تنظیمات، مسیر وب‌هوک، رویدادها و دستور sheypay:test.
اولین رسیدتان را امروز صادر کنید
ثبت‌نام با شمارهٔ موبایل انجام می‌شود و تا تأیید مدارک، همه‌چیز را در محیط آزمایشی امتحان می‌کنید.