۲. افزودن برنامه‌ها و اتصال فروشگاه‌ها
آموزش افزودن برنامه کافه‌بازار، مایکت، مستقل و PWA به پروژه اینپی فای
هر برنامه در اینپی فای نماینده یک خروجی قابل انتشار از محصول شماست. اگر یک اپلیکیشن را در کافه‌بازار، مایکت، به‌صورت مستقل یا به شکل PWA منتشر می‌کنید، برای هر روش انتشار یک برنامه جدا بسازید؛ چون اطلاعات اتصال و روش اعتبارسنجی خرید آن‌ها با هم متفاوت است.
قبل از شروع
این اطلاعات را آماده کنید:
- Package Name برنامه اندروید یا Bundle ID برنامه iOS؛
- یک نام داخلی برای تشخیص برنامه در پنل اینپی فای؛
- برای کافه‌بازار و مایکت، کلید RSA و کلید API همان برنامه در پنل فروشگاه؛
- آدرس بازگشت به برنامه یا صفحه نتیجه پرداخت، در صورت استفاده از پرداخت مستقیم.
Package Name، کلید RSA و کلید API باید همگی متعلق به همان برنامه و همان فروشگاه باشند. کلیدهای یک برنامه دیگر را کپی نکنید.
افزودن برنامه کافه‌بازار
۱. رفتن به صفحه برنامه‌ها
پروژه را انتخاب کنید و از منوی کناری به برنامه‌ها ← پیکربندی بروید. سپس افزودن پیکربندی برنامه را بزنید.
۲. انتخاب کافه‌بازار
در بخش فروشگاه‌های ایرانی، گزینه یک برنامه جدید برای کافه‌بازار ایجاد کنید را انتخاب کنید.
۳. تکمیل مشخصات برنامه
در فرم برنامه کافه‌بازار:
- نام پکیج (Package Name) را دقیقاً مطابق برنامه ثبت‌شده در بازار وارد کنید.
- نام داخلی را برای تشخیص این برنامه در پنل بنویسید.
- نام نمایشی را وارد کنید.
- مقدار کلید برنامه و کلید عمومی برنامه را طبق دو مرحله بعد از پیشخان بازار دریافت کنید.
۴. دریافت کلید RSA بازار
وارد پیشخان توسعه‌دهندگان کافه‌بازار شوید و این مسیر را باز کنید:
برنامه‌ها ← برنامه موردنظر ← پرداخت درون‌برنامه‌ای ← تنظیمات
کلید RSA یا کلید عمومی پرداخت نمایش‌داده‌شده در این صفحه را کامل کپی کنید و در فیلد کلید برنامه اینپی فای قرار دهید.
۵. دریافت کلید API پیشخوان بازار
در پیشخان بازار این مسیر را باز کنید:
برنامه‌ها ← برنامه موردنظر ← API پیشخوان
کلید یا توکن API مخصوص همان برنامه را ایجاد یا کپی کنید و در فیلد کلید عمومی برنامه اینپی فای قرار دهید. اینپی فای از این مقدار برای ارتباط سرور با بازار و اعتبارسنجی خریدها استفاده می‌کند.
در اینپی فای، «کلید برنامه» محل واردکردن کلید RSA بازار است و «کلید عمومی برنامه» محل واردکردن کلید API پیشخوان بازار است.
۶. ذخیره برنامه
تنظیمات بازگشت از پرداخت را بررسی کنید و ذخیره تغییرات را بزنید. پس از ساخت، اینپی فای کلید اتصال SDK این برنامه را ایجاد می‌کند؛ کلید SDK با کلید RSA و API پیشخوان تفاوت دارد.
افزودن برنامه مایکت
- در اینپی فای به برنامه‌ها ← پیکربندی بروید و افزودن پیکربندی برنامه را بزنید.
- گزینه یک برنامه جدید برای مایکت ایجاد کنید را انتخاب کنید.
- Package Name را دقیقاً مطابق برنامه ثبت‌شده در مایکت وارد کنید.
- وارد پنل توسعه‌دهندگان مایکت شوید و برنامه متناظر را انتخاب کنید.
- کلید RSA پرداخت درون‌برنامه‌ای همان برنامه را دریافت و در فیلد کلید برنامه اینپی فای وارد کنید.
- کلید یا توکن API مربوط به استعلام خرید همان برنامه را از بخش API پنل مایکت دریافت و در فیلد کلید عمومی برنامه قرار دهید.
- نام داخلی، نام نمایشی و تنظیمات بازگشت از پرداخت را تکمیل و برنامه را ذخیره کنید.
اطلاعات بازار و مایکت قابل جایگزینی با یکدیگر نیستند. حتی اگر Package Name دو نسخه یکسان است، برای هر فروشگاه برنامه جدا بسازید و کلیدهای همان فروشگاه را وارد کنید.
افزودن برنامه مستقل
برنامه مستقل برای نسخه‌ای است که از کافه‌بازار یا مایکت استفاده نمی‌کند و انتشار و پرداخت آن مستقیماً توسط شما انجام می‌شود.
- به برنامه‌ها ← پیکربندی ← افزودن پیکربندی برنامه بروید.
- در بخش برنامه‌های مستقل، یک برنامه اندروید جدید ایجاد کنید یا یک برنامه آی‌اواس جدید ایجاد کنید را بزنید.
- برای اندروید Package Name و برای iOS Bundle ID را وارد کنید.
- نام داخلی و نام نمایشی برنامه را تکمیل کنید.
- روش بازگشت از پرداخت را انتخاب کنید: صفحه نتیجه اینپی فای یا آدرس بازگشت اختصاصی برنامه.
- در صورت انتخاب آدرس اختصاصی، Deep Link یا Callback URL معتبر برنامه را وارد کنید.
- برنامه را ذخیره کنید.
تصاویر بالا نمونه برنامه مستقل اندروید هستند. برای برنامه مستقل iOS همین مراحل را انجام دهید؛ تنها به‌جای Package Name باید Bundle ID نسخه iOS را وارد کنید.
برای برنامه مستقل، فیلدهای کلید RSA فروشگاه و API پیشخوان بازار یا مایکت لازم نیست؛ زیرا اعتبارسنجی خرید فروشگاهی انجام نمی‌شود.
افزودن برنامه PWA
پیکربندی PWA برای وب‌اپلیکیشنی است که کاربران خرید را مستقیماً از طریق سایت شما انجام می‌دهند.
۱. رفتن به پیکربندی وب
پروژه را انتخاب کنید و به برنامه‌ها ← پیکربندی بروید. در بخش پیکربندی وب (PWA)، دکمه افزودن پیکربندی وب را بزنید.
۲. ساخت وب‌اپلیکیشن
گزینه یک برنامه وب اپلیکیشن جدید ایجاد کنید را انتخاب کنید.
۳. تکمیل اطلاعات PWA
در فرم برنامه وب:
- نام داخلی را برای تشخیص برنامه در پنل وارد کنید.
- نام نمایشی را بنویسید؛ این نام در بخش‌های قابل مشاهده برای کاربر استفاده می‌شود.
- در صورت نیاز ایمیل پشتیبانی را وارد کنید. اگر خالی بماند، ایمیل حساب کاربری استفاده می‌شود.
- در بخش لینک‌های دانلود، آدرس مشاهده یا دانلود برنامه در پلتفرم‌های موردنظر را اضافه کنید.
- در فیلد دامنه اصلی PWA (Origin) فقط پروتکل و دامنه را وارد کنید؛ برای نمونه
https://app.example.com. - ذخیره تغییرات را بزنید.
Origin نباید مسیر، Query String یا Fragment داشته باشد. مقدارهایی مانند https://app.example.com/payment-result یا https://app.example.com?source=pwa معتبر نیستند؛ فقط https://app.example.com را وارد کنید.
تفاوت کلیدها
| مقدار در اینپی فای | منبع | کاربرد |
|---|---|---|
| کلید برنامه | RSA پرداخت درون‌برنامه‌ای همان برنامه در بازار یا مایکت | بررسی امضای خرید فروشگاهی |
| کلید عمومی برنامه | API پیشخوان بازار یا API برنامه در مایکت | ارتباط سرور اینپی فای با فروشگاه و استعلام خرید |
| کلید SDK اینپی فای | پس از ساخت برنامه در پنل اینپی فای | اتصال اپلیکیشن به SDK اینپی فای |
توکن API فروشگاه و کلیدهای محرمانه را داخل اپلیکیشن، فایل عمومی یا مخزن کد قرار ندهید.
این مرحله چه زمانی کامل است؟
- برای هر فروشگاه یا روش انتشار، یک برنامه جدا در اینپی فای ساخته شده است؛
- Package Name یا Bundle ID با نسخه واقعی برنامه یکسان است؛
- برنامه بازار، RSA را از پرداخت درون‌برنامه‌ای ← تنظیمات و کلید API را از API پیشخوان گرفته است؛
- برنامه مایکت از کلیدهای همان برنامه در پنل مایکت استفاده می‌کند؛
- برای برنامه مستقل، مسیر بازگشت از پرداخت بررسی شده است؛
- برای PWA، Origin معتبر و لینک‌های دانلود موردنیاز ثبت شده‌اند؛
- کلید اتصال SDK برنامه در پنل قابل مشاهده است.