Parbad (ASP.NET) شی‌پی
اگر سایت ASP.NET شما با Parbad به درگاه‌ها وصل است، این بسته شی‌پی را مثل بقیهٔ درگاه‌ها اضافه می‌کند. RequestAsync پرداخت را می‌سازد، FetchAsync شناسهٔ پرداختِ برگشتی را با شناسهٔ ذخیره‌شده مقایسه می‌کند و VerifyAsync پرداخت را سمت سرور با مبلغ و شمارهٔ پیگیری Parbad تأیید می‌کند. استرداد کامل و جزئی هم پشتیبانی می‌شود. مبلغ‌ها مثل خود Parbad به ریال‌اند.
- استرداد از داخل پنل
- تومان و ریال
- حالت آزمایشی با sk_test_
این نسخه بتا است: کامل است ولی هنوز روی فروشگاه‌های واقعی کافی اجرا نشده. اول روی نسخهٔ آزمایشی سایتتان و با کلید sk_test_ امتحانش کنید و هر اشکالی دیدید به پشتیبانی بگویید.
نصب
- ۱
پوشهٔ src بسته را کنار پروژه بگذارید و با dotnet add reference به Parbad.Gateway.SheyPay.csproj ارجاع دهید.
- ۲
در Program.cs درگاه را با AddSheyPay() و کلید API ثبت کنید (نمونه در README).
- ۳
در ساخت فاکتور UseSheyPay() را صدا بزنید؛ مبلغ به ریال است.
- ۴
آدرس بازگشت باید روی دامنهٔ ثبت‌شدهٔ درگاه در پنل شی‌پی باشد.
تنظیمات
- ApiKey
- کلید API شی‌پی؛
sk_test_برای آزمایش. - BaseUrl
- اختیاری، در WithOptions؛ پیش‌فرض
https://sheypay.site. - SetSheyPayData
- اختیاری: موبایل، ایمیل، نام و شرح پرداخت.
تست در محیط آزمایشی
با کلید sk_test_ پول واقعی جابه‌جا نمی‌شود و در صفحهٔ بانک آزمایشی نتیجه را خودتان انتخاب می‌کنید.
- با کلید
sk_test_یک RequestAsync بزنید و به درگاه بروید. - در بانک آزمایشی «موفق» را بزنید؛ FetchAsync باید ReadyForVerifying و VerifyAsync باید Succeed با کد پیگیری بدهد.
- RefundAsync را برای یک پرداخت تأییدشده امتحان کنید.
مشکلات رایج
Fetch ناموفق است.
آدرس بازگشت باید همان callback ساخته‌شده توسط Parbad باشد تا payment_id برگشتی با شناسهٔ ذخیره‌شده یکی باشد.
Verify در حالت در انتظار ناموفق شد.
Parbad حالت در انتظار ندارد؛ شی‌پی پرداخت تأییدنشده را خودکار برگشت می‌زند و پول مشتری برمی‌گردد.
مبلغ ده برابر یا یک‌دهم است.
Parbad با ریال کار می‌کند؛ مبلغ تومانی را ضرب در ۱۰ کنید.
تغییرات
نسخهٔ ۱.۰.۰
- نسخهٔ اول: درخواست، بررسی بازگشت، تأیید سمت سرور و استرداد.
اولین رسیدتان را امروز صادر کنید
ثبت‌نام با شمارهٔ موبایل انجام می‌شود و تا تأیید مدارک، همه‌چیز را در محیط آزمایشی امتحان می‌کنید.