کتابخانهٔ Java شی‌پی
کتابخانهٔ Java شی‌پی برای Spring Boot، Jakarta EE و هر برنامهٔ Java 11 به بالا. پرداخت و استرداد به کلاس‌های تایپ‌شده تبدیل می‌شوند، confirm نتیجه را در سه حالت PAID، PENDING و FAILED برمی‌گرداند و کلاس Webhook امضای HMAC را با مقایسهٔ زمان‌ثابت بررسی می‌کند.
- تایپ‌های کامل
- استرداد از داخل پنل
- وب‌هوک امضاشده
- وضعیت «در انتظار» درست
- تومان و ریال
- حالت آزمایشی با sk_test_
- دکمهٔ تست اتصال
این نسخه بتا است: کامل است ولی هنوز روی فروشگاه‌های واقعی کافی اجرا نشده. اول روی نسخهٔ آزمایشی سایتتان و با کلید sk_test_ امتحانش کنید و هر اشکالی دیدید به پشتیبانی بگویید.
نصب
- ۱
zip را باز کنید و در پوشهٔ sheypay-java دستور mvn install را بزنید.
- ۲
وابستگی ir.sheypay:sheypay-java:1.0.0 را به pom.xml یا build.gradle پروژه اضافه کنید.
- ۳
کلید API را در SHEYPAY_KEY بگذارید (برای آزمایش
sk_test_). - ۴
با createPayment پرداخت بسازید و در کنترلر بازگشت confirm را با شناسهٔ ذخیره‌شده و مبلغ سفارش صدا بزنید.
- ۵
کنترلر وب‌هوک را با Webhook.constructEvent و بدنهٔ خام درخواست بسازید.
- نسخهٔ بتا: روی محیط آزمایشی امتحان کنید.
تنظیمات
- new SheyPay(apiKey, baseUrl, timeout, clientInfo)
- سازندهٔ ساده فقط کلید می‌گیرد؛ مهلت پیش‌فرض ۲۰ ثانیه.
- Idempotency-Key
- آرگومان دوم createPayment و آخر refund.
- SheyPay.toRial(amount, true)
- تبدیل تومان به ریال.
تست در محیط آزمایشی
با کلید sk_test_ پول واقعی جابه‌جا نمی‌شود و در صفحهٔ بانک آزمایشی نتیجه را خودتان انتخاب می‌کنید.
- با کلید
sk_test_پرداخت بسازید و در بانک آزمایشی نتیجه را انتخاب کنید. - نتیجه‌های PAID، PENDING و FAILED را در کنترلر بازگشت امتحان کنید.
- از پنل شی‌پی رویداد آزمایشی وب‌هوک بفرستید.
مشکلات رایج
constructEvent خطای امضا می‌دهد.
در Spring بدنه را با @RequestBody String بگیرید تا دست‌نخورده بماند.
خطای callback_domain_mismatch
آدرس بازگشت باید روی دامنهٔ تأییدشدهٔ درگاه باشد.
تغییرات
نسخهٔ ۱.۰.۰
- نسخهٔ اول: همهٔ متدهای API پرداخت، confirm و ابزار وب‌هوک.
اولین رسیدتان را امروز صادر کنید
ثبت‌نام با شمارهٔ موبایل انجام می‌شود و تا تأیید مدارک، همه‌چیز را در محیط آزمایشی امتحان می‌کنید.