خرید محصول مصرفی (سکه، جان و…)
این عملکرد برای فروش محصولی است که کاربر می‌تواند چند بار بخرد؛ مانند بستهٔ سکه، جان یا راهنمای بازی. پس از پرداخت، محصول در مارکت مصرف می‌شود تا دوباره قابل خرید باشد. افزودن سکه یا محتوای بسته را خودتان در عملکرد پس از موفقیت تعریف می‌کنید.
برای فروش دسترسی به صفحه، اشتراک یا حذف تبلیغات، از عملکرد خرید / نمایش گزینه‌های خرید استفاده کنید.
آماده‌سازی
- در تنظیمات پرداخت اپ، سیستم پرداخت مارکت پیش‌فرض را انتخاب و کلید RSA بازار یا مایکت را وارد کنید.
- محصول را در پنل همان مارکت با نوع یکبار خرید بسازید. این عملکرد پس از پرداخت آن را مصرف می‌کند و خرید بعدی ممکن می‌شود.
- در بخش خریدنی اپ‌ادیتور، آیتمی با همان کد محصول تعریف کنید؛ مثلاً
coins_100. - عملکرد خرید محصول مصرفی (سکه، جان و…) را به دکمهٔ خرید وصل کنید و کد محصول را انتخاب کنید.
- در عملکرد پس از موفقیت، محتوای بسته را تحویل دهید و مقدار تازه را ذخیره کنید؛ مثلاً ۱۰۰ واحد به متغیر سکهٔ ذخیره‌شده روی دستگاه اضافه کنید.
این قابلیت به خروجی جدید اندروید با پرداخت بازار یا مایکت نیاز دارد. خرید واقعی در وب، ویندوز و سیستم پرداخت زرین‌پال پشتیبانی نمی‌شود. خرید مصرفی با سرور اپ‌ادیتور همگام نمی‌شود و برای اجرای آن حساب کاربری داخل اپ لازم نیست؛ حفظ موجودی یا همگام‌سازی آن بین دستگاه‌ها را باید در طراحی اپ در نظر بگیرید.
تنظیمات عملکرد
| تنظیم | کاربرد |
|---|---|
| عمل | «خرید»، «بازیابی خریدی که پرداخت شده ولی تحویل نشده» یا «دریافت قیمت از مارکت» |
| کد محصول | انتخاب از آیتم‌های خریدنی، نوشتن کد یا استفاده از متغیر مانند {{productCode}} |
| عملکرد پس از موفقیت | تحویل محتوای خرید یا نمایش قیمت دریافت‌شده، متناسب با عمل انتخاب‌شده |
| عملکرد در صورت شکست | نمایش پیام یا امکان تلاش مجدد |
| ذخیره نتیجه در متغیر | نام متغیر متنی نتیجه؛ اگر وجود نداشته باشد خودکار ساخته می‌شود |
نتیجهٔ خرید و بازیابی
| مقدار | معنی و اقدام مناسب |
|---|---|
purchased | خرید تازه انجام و در مارکت مصرف شد؛ محتوا را تحویل دهید. |
recovered | خرید پرداخت‌شدهٔ قبلی اکنون در مارکت مصرف شد؛ محتوا را تحویل دهید. |
pending | پرداخت انجام شده ولی مصرف محصول تأیید نشده است؛ هنوز محتوا ندهید و بعداً بازیابی کنید. |
none | در بازیابی، خریدی برای تحویل پیدا نشد؛ چیزی به موجودی اضافه نکنید. |
cancelled | کاربر از خرید منصرف شده است. |
failed | عملیات انجام نشد؛ امکان تلاش مجدد بدهید. |
busy | عملیات خرید دیگری در جریان است؛ تا پایان آن صبر کنید. |
unsupported | پلتفرم یا سیستم پرداخت از این خرید پشتیبانی نمی‌کند. |
در خرید و بازیابی، فقط نتیجه‌های purchased و recovered عملکرد موفقیت را اجرا می‌کنند. نتیجه پیش از اجرای عملکرد بعدی در متغیر نوشته می‌شود. عملیات چند محصول را یکی‌یکی اجرا کنید تا با خرید جاری تداخل نداشته باشند.
بازیابی خرید تحویل‌نشده
ممکن است پرداخت انجام شود اما به دلیل قطع ارتباط یا بسته‌شدن اپ، مصرف محصول کامل نشود. هنگام باز شدن فروشگاه داخل اپ، برای هر محصول یک عملکرد از نوع بازیابی خریدی که پرداخت شده ولی تحویل نشده اجرا کنید. اگر نتیجه recovered بود، محتوای همان بسته را اضافه و بلافاصله ذخیره کنید.
بازیابی، موجودی سکهٔ قبلاً تحویل‌شده را پس از حذف اپ یا روی دستگاه دیگر برنمی‌گرداند؛ فقط خرید پرداخت‌شده‌ای را بررسی می‌کند که هنوز در مارکت مصرف نشده است.
دریافت قیمت
با انتخاب دریافت قیمت از مارکت، متن قیمت همان مارکت در متغیر نتیجه قرار می‌گیرد. از نمایشگر متغیر برای نشان دادن آن کنار دکمهٔ خرید استفاده کنید. متن غیرخالی موفقیت محسوب می‌شود؛ اگر قیمت دریافت نشود، نتیجه خالی و عملکرد شکست اجرا می‌شود. برای این عمل، عملکرد موفقیت را به افزایش سکه متصل نکنید.
آزمایش
پیش‌نمایش پنل پرداخت واقعی انجام نمی‌دهد: خرید نتیجهٔ آزمایشی purchased، بازیابی none و قیمت رشتهٔ خالی برمی‌گرداند. خرید، انصراف و بازیابی را پیش از انتشار روی خروجی اندروید و مارکت مقصد بررسی کنید.