شروع کار با SDKهای اینپیفای
راهنمای Kotlin و Flutter نسخه 0.2.1 و Web نسخه 0.2.0؛ از نصب و هویت تا خرید، حق دسترسی و تحویل مصرفی.
این بخش مسیر اتصال اپلیکیشن به اینپیفای را از نصب تا اولین خرید قابل تأیید توضیح میدهد. مبنای مثالها Kotlin 0.2.1، Flutter 0.2.1 و Web 0.2.0 است. شماره نسخهها مستقلاند؛ نسخه فلاتر را بهجای نسخه فراهمکننده JavaScript وب استفاده نکنید.
پلتفرم خود را انتخاب کنید
| SDK یا پلتفرم | شروع | مسیر پرداخت |
|---|---|---|
| Kotlin روی Android | نصب کاتلین | Direct، کافهبازار و مایکت |
| Flutter روی Android | نصب فلاتر | همان مسیرها از طریق Kotlin |
| Flutter روی iOS | نصب فلاتر | Direct؛ بدون StoreKit و خرید App Store |
| وب و PWA با JavaScript | راهنمای وب | Web checkout |
| Flutter Web | وب و نصب پل | همان فراهمکننده وب با پوشش متفاوت پل |
بازار و مایکت مخصوص اندرویدند و اشتراک مایکت پشتیبانی نمیشود. پیش از مشترککردن کد چند پلتفرم، جدول قابلیتها را بخوانید.
پیشنیازهای پنل
پروژه و برنامه، محصول، حق دسترسی و آفرینگ را آماده کنید. محصول باید به حق دسترسی مناسب متصل باشد. کلید عمومی همان برنامه را از کلیدها بگیرید؛ وب به Public Web App Key نیاز دارد. کلید محرمانه سرور را داخل کلاینت قرار ندهید.
مسیر پیشنهادی پیادهسازی
- SDK پلتفرم را نصب و یک بار پیکربندی کنید.
- هویت و تغییر حساب را به احراز هویت اپ خود وصل کنید.
- ویژگیهای مشتری را ثبت و آفرینگ و پکیج مناسب را نمایش دهید.
- با همان Package دریافتی خرید را شروع کنید؛ تخفیف مسیر مخصوص خود را دارد.
- CustomerInfo و بازیابی یا تحویل مصرفی را برای محصول مربوط اجرا کنید.
- آزمون و عیبیابی را کامل کنید؛ مرجع متدها برای حالتها و پیشفرضها در دسترس است.
سه مفهوم متفاوت
Product چیزی است که خریده میشود؛ Package جای آن محصول در یک Offering است؛ Entitlement دسترسی حاصل از خرید است. برای بازکردن امکانات، حق دسترسی premium را بررسی کنید، نه نام محصول یا یک فلگ محلی. اعتبار مصرفی نیز فقط پس از تحویل ماندگار در موجودی اپ شما ثبت میشود.
موفقیت configure، ساختهشدن لینک پرداخت و تکمیل پرداخت سه رویداد متفاوتاند. نمونههای این راهنما شناسههای فرضی مثل customer_123 و special_offer دارند؛ آنها را با شناسههای پنل خود جایگزین کنید.
استفاده با ایجنت
Skill رسمی SDK همین قراردادها و محدودیتها را در اختیار ایجنت توسعهدهنده قرار میدهد؛ نصب آن جای نصب بسته SDK نیست.