فروش محصولات درون‌برنامه‌ای (IAP)

1📥 راهنما و اپلیکیشن دموی کارا را بگیرید#

همهٔ مطالب این راهنما به‌صورت PDF هم هست که می‌توانید آفلاین بخوانید، به‌علاوهٔ یک اپلیکیشن دمو کامل که امروز می‌توانید بسازید و اجرا کنید.

زیر را بزنید تا هر دو در گوشی شما زیر Downloads/AppMint/Guides ذخیره شوند:

• AppMint-InApp-Purchases-Guide.pdf - راهنمای کامل، شامل مراحل Play Console و مثال‌های React / Next.js
• iap-demo-index.html - یک بازی کوچک که سه چیز می‌فروشد: حذف تبلیغات (یک‌باره)، یک بستهٔ مرحله (یک‌باره) و یک بلیت فصلی ماهانه

برای امتحان دمو: iap-demo-index.html را به‌تنهایی ZIP کنید، در stepper بارگذاری کنید و راهنما را دنبال کنید. سریع‌ترین راه برای دیدن یک خرید واقعی از ابتدا تا انتها پیش از دست زدن به اپلیکیشن خودتان است.

2این چیست؟ (به زبان ساده)#

اپلیکیشن شما می‌تواند چیزهایی بفروشد - ارتقای پرو، مرحله‌های اضافه، اشتراک - و Google پول را جمع می‌کند و هر ماه به شما می‌پردازد.

یک مثال را با هم می‌سازیم، در سرتاسر این راهنما:

A game that sells two things
  • 'Levels 11-20'      ₹99  paid once, kept forever
  • 'Remove ads'        ₹49  every month

در پایان فقط چهار خط به صفحهٔ خود اضافه می‌کنید. تمام کار همین است - لازم نیست کد خرید بنویسید، و حتی اگر تا حالا این کار را نکرده‌اید، مشکلی پیش نمی‌آید.

لازم نیست بیش از کپی و جای‌گذاری برنامه‌نویسی بدانید، و به سرور، پایگاه داده یا حساب شرکت پرداخت هم نیاز ندارید. Google Play کارهای سخت را انجام می‌دهد:

• صفحهٔ پرداخت را نشان می‌دهد (کارت / UPI / صورتحساب اپراتور)
• قیمت شما را به ارز هر کشور تبدیل می‌کند
• به یاد می‌آورد چه کسی چه چیزی خریده - حتی بعد از نصب دوباره
• پول را به بانک شما می‌فرستد

AppMint ۰٪ برمی‌دارد - فروش مستقیم به حساب Google Play خودتان می‌رود.

برای Website → APK، ZIP → APK و اپلیکیشن‌های ساخته‌شده با هوش مصنوعی یکسان کار می‌کند.

3پیش از شروع به چه چیزی نیاز دارید#

فقط چهار چیز:

1. وب‌سایت یا اپلیکیشن HTML/ZIP شما (چیزی که به APK تبدیل می‌کنید).
2. چیزی برای فروش - تصمیم بگیرید خریداران چه چیزی دریافت می‌کنند (مثلاً «نسخهٔ پرو»: بدون محدودیت، محتوای اضافه).
3. یک حساب توسعه‌دهندهٔ Google Play - هزینهٔ یک‌باره ۲۵ دلار در play.google.com/console. برای انتشار هر اپلیکیشنی در Play Store به آن نیاز دارید، نه فقط اپلیکیشن‌های پولی.
4. در مجموع حدود ۱ ساعت، پخش‌شده در مرحله‌های زیر.

دانستن این از ابتدا مهم است: خریدهای درون‌برنامه‌ای فقط وقتی کار می‌کنند که اپلیکیشن شما از Play Store نصب شده باشد. این قانون Google برای همه است، نه محدودیت AppMint.

4مرحلهٔ ۱ - شناسهٔ محصول خود را بسازید#

شناسهٔ محصول فقط یک نام کوتاه است که برای چیزی که می‌فروشید می‌سازید. بعداً همین نام را در دو جا تایپ می‌کنید (صفحهٔ شما + Play Console)، پس ساده نگهش دارید و یادداشت کنید.

قوانین: فقط حروف کوچک، اعداد، زیرخط. باید با حرف یا عدد شروع شود.

یکی از این‌ها را کپی کنید:

• pro_unlock - ارتقای «نسخهٔ پرو» (پیش‌فرض خوب - کد زیر از قبل از آن استفاده می‌کند)
• remove_ads - ارتقای بدون تبلیغ
• level_pack_2 - بستهٔ محتوای اضافه
• coins_100 - بستهٔ ارز بازی
• premium_monthly - اشتراک ماهانه

قیمت بخشی از شناسه نیست - قیمت را در مرحلهٔ ۵ تعیین می‌کنید و می‌توانید هر زمان بدون دست زدن به کد آن را تغییر دهید.

5مرحلهٔ ۲ - دکمهٔ خود را علامت بزنید (بدون کد نوشتن)#

لازم نیست هیچ کد خریدی بنویسید. اپلیکیشن شما از قبل موتور خرید را دارد - فقط HTML خودتان را برچسب می‌زنید تا بداند چه بفروشد.

بلوک زیر را در صفحهٔ خود کپی کنید و فقط این‌ها را تغییر دهید:

(۱) pro_unlock ← شناسهٔ محصول شما، در data-iap-buy
(۲) کلمات روی دکمه و داخل بخش پولی

همین. بعد دکمه قیمت واقعی Google را به ارز خود خریدار نشان می‌دهد، با زدن صفحهٔ پرداخت Google را باز می‌کند، بخش پولی را پس از پرداخت آشکار می‌کند (و در هر راه‌اندازی برای کسانی که قبلاً خریده‌اند)، اگر اشتراک منقضی شود یا پرداخت بازپرداخت شود آن را پس می‌گیرد، و اگر مشکلی پیش بیاید پیام روشنی نشان می‌دهد.

چهار برچسب:

• data-iap-buy="id" - این را دکمهٔ خرید می‌کند (الزامی)
• data-iap-label="…{price}…" - متن دکمه؛ {price} به قیمت واقعی Google تبدیل می‌شود
• data-iap-owned="…" - متن دکمه بعد از خرید
• data-iap-show - بخشی که فقط پس از خرید ظاهر می‌شود (آن را 'hidden' شروع کنید)

همچنین موجود است: data-iap-hide (بعد از خرید ناپدید می‌شود)، data-iap-container (یک پوشش که فقط داخل اپلیکیشن ظاهر می‌شود)، data-iap-text (اگر دکمه‌تان آیکون هم دارد، آن را روی <span> حاوی متن بگذارید).

چند چیز مختلف می‌فروشید؟ برای هر کدام یک دکمه اضافه کنید. آن‌ها مستقل‌اند - یک اپلیکیشن می‌تواند تبلیغات را حذف کند و بستهٔ مرحله بفروشد و اشتراک هم داشته باشد، و خرید یکی هرگز روی بقیه اثر نمی‌گذارد. یک بخش را با data-iap-show="level_pack_2" به یک محصول وصل کنید.

فقط شناسه‌هایی که در «Remove Ads (IAP) ← Product ID» تایپ می‌کنید تبلیغات را خاموش می‌کنند. هر چیز دیگری که می‌فروشید هر کاری را که صفحه‌تان با آن می‌کند باز می‌کند و تبلیغات ادامه دارند.

دو طرح برای یک چیز (ماهانه در برابر دائمی)؟ به هر دو دکمه data-iap-group="adfree" یکسان بدهید - آن‌وقت خرید هر کدام دیگری را پنهان می‌کند، پس هیچ‌کس دوبار پرداخت نمی‌کند. بدون group چیزی پنهان نمی‌شود، که برای محصولات نامرتبط همین لازم است.

<!-- (1) CHANGE pro_unlock to your product ID -->
<button data-iap-buy="pro_unlock"
        data-iap-label="Unlock Pro — {price}"
        data-iap-owned="✓ Unlocked">
  Unlock Pro
</button>

<!-- (2) CHANGE the words. Appears only after buying. -->
<div data-iap-show hidden>
  🎉 Pro content here — visible after buying.
</div>

<!-- Optional: disappears after buying -->
<div data-iap-hide>
  Upgrade to remove the ads.
</div>

<!-- DIFFERENT THINGS: independent — buying one never affects the others -->
<button data-iap-buy="remove_ads"   data-iap-label="Remove ads — {price}">Remove ads</button>
<button data-iap-buy="level_pack_2" data-iap-label="Levels 11-20 — {price}">Get levels</button>

<div data-iap-show="level_pack_2" hidden>Levels 11-20 unlocked!</div>

<!-- SAME THING, TWO PLANS: one group, so buying either hides the other -->
<button data-iap-buy="remove_ads_monthly"  data-iap-group="adfree"
        data-iap-label="Remove ads — {price}/month"
        data-iap-owned="✓ Ad-free (monthly)">Remove ads monthly</button>

<button data-iap-buy="remove_ads_lifetime" data-iap-group="adfree"
        data-iap-label="Remove ads forever — {price}"
        data-iap-owned="✓ Ads removed forever">Remove ads forever</button>

6۴ چیزی که مردم معمولاً می‌فروشند#

هر کدام را که با شما می‌خواند انتخاب کنید. تنها تفاوت آن‌ها محل ساخت محصول در Play Console است - کد صفحهٔ شما هر بار همان شکل را دارد.

1. حذف تبلیغات، یک‌بار پرداخت (برای همیشه)

آن را اینجا بسازید: In-app products
شناسه را همچنین در این‌جا تایپ کنید: Remove Ads (IAP) ← Product ID

1. حذف تبلیغات، ماهانه

آن را اینجا بسازید: Subscriptions
شناسه را همچنین در این‌جا تایپ کنید: Remove Ads (IAP) ← Product ID

1. باز کردن مرحله‌ها / محتوا، یک‌بار پرداخت

آن را اینجا بسازید: In-app products
آن را در کادر Remove Ads تایپ نکنید - تبلیغات شما ادامه می‌یابند.

1. باز کردن مرحله‌ها / محتوا، ماهانه

آن را اینجا بسازید: Subscriptions
آن را در کادر Remove Ads تایپ نکنید - تبلیغات شما ادامه می‌یابند.

می‌توانید هر چهار مورد را در یک اپلیکیشن بفروشید، و هر تعداد محصول که بخواهید. خرید یکی هرگز روی بقیه اثر نمی‌گذارد.

<!-- 1. remove ads, paid once -->
<button data-iap-buy="remove_ads_lifetime"
        data-iap-label="Remove ads forever — {price}"
        data-iap-owned="✓ Ads removed">Remove ads forever</button>

<!-- 2. remove ads, monthly -->
<button data-iap-buy="remove_ads_monthly"
        data-iap-label="Remove ads — {price}/month"
        data-iap-owned="✓ Ad-free">Remove ads monthly</button>

<!-- 3. levels, paid once -->
<button data-iap-buy="level_pack_2"
        data-iap-label="Levels 11-20 — {price}"
        data-iap-owned="✓ Unlocked">Get levels 11-20</button>

<!-- 4. all levels, monthly -->
<button data-iap-buy="all_levels_monthly"
        data-iap-label="All levels — {price}/month"
        data-iap-owned="✓ Subscribed">Subscribe</button>

7کدام خریدها تبلیغات را حذف می‌کنند؟#

این همان چیزی است که مردم اشتباه می‌کنند، پس ۳۰ ثانیه ارزش دارد.

تبلیغات شما بخشی از صفحهٔ وب شما نیستند. آن‌ها تبلیغات واقعی اندروید هستند که روی آن قرار می‌گیرند، پس هیچ چیز در صفحهٔ شما نمی‌تواند آن‌ها را خاموش کند. فقط یک چیز می‌تواند:

wizard Step 3 → Remove Ads (IAP) → Product ID

هر شناسه‌ای که در آن کادر بنویسید، وقتی کسی آن را بخرد تبلیغات را حذف می‌کند. هر شناسهٔ دیگری که می‌فروشید فقط هر کاری را که صفحه‌تان با آن می‌کند باز می‌کند، و تبلیغات ادامه دارند.

هم یک طرح بدون تبلیغ و هم بستهٔ مرحله می‌فروشید؟ فقط شناسهٔ طرح بدون تبلیغ را در آن کادر بنویسید. در مثال ما:

Product ID box:  remove_ads_monthly
NOT in the box:  level_pack_2

دو طرح بدون تبلیغ (ماهانه و دائمی) ارائه می‌دهید؟ هر دو را در همان یک کادر بگذارید، با کاما جدا کنید - مالکیت هر کدام تبلیغات را حذف می‌کند:

remove_ads_monthly,remove_ads_lifetime

اصلاً حذف تبلیغات را نمی‌فروشید؟ آن کلید را کاملاً خاموش بگذارید و فقط از «💰 Sell In-App Products» استفاده کنید.

Selling levels only:
  Remove Ads (IAP)          OFF
  Sell In-App Products      ON

Selling ad removal only:
  Remove Ads (IAP)          ON   → Product ID: remove_ads_monthly
  Sell In-App Products      ON

Selling both, with two ad-free plans:
  Remove Ads (IAP)          ON   → Product ID: remove_ads_monthly,remove_ads_lifetime
  Sell In-App Products      ON
  (level_pack_2 stays out of the box)

8مثال کامل - صفحهٔ HTML ساده#

این هم کل اپلیکیشن مثال ما: «Levels 11-20» را یک‌بار می‌فروشد، و «Remove ads» را ماهانه. آن را کپی کنید، دو شناسه و کلمات را تغییر دهید، و تمام.

بخوانید هر برچسب چه کاری می‌کند:

• data-iap-buy ← این دکمه چه چیزی می‌فروشد
• data-iap-label ← متن؛ {price} به قیمت واقعی Google تبدیل می‌شود
• data-iap-owned ← متن بعد از پرداخت
• data-iap-show="level_pack_2" ← این کادر فقط بعد از خرید همان محصول ظاهر می‌شود
• data-iap-hide ← این کادر با خرید هر چیزی ناپدید می‌شود

توجه کنید که هیچ <script> و هیچ کد خریدی نیست. اپلیکیشن شما از قبل آن را دارد.

<h2>Get more levels</h2>

<button data-iap-buy="level_pack_2"
        data-iap-label="Levels 11-20 — {price}"
        data-iap-owned="✓ Levels 11-20 unlocked">
  Levels 11-20
</button>

<div data-iap-show="level_pack_2" hidden>
  🎉 Levels 11 to 20 are yours. Have fun!
</div>


<h2>Tired of ads?</h2>

<button data-iap-buy="remove_ads_monthly"
        data-iap-label="Remove ads — {price}/month"
        data-iap-owned="✓ No more ads">
  Remove ads
</button>

<div data-iap-hide>
  Ads help keep this game free.
</div>

9مثال کامل - React یا Next.js#

روش آسان: دقیقاً همین برچسب‌ها در React و Next.js کار می‌کنند، چون فقط نشانه‌گذاری‌اند. بدون useState، بدون useEffect، بدون 'use client'. دکمه‌هایی که React بعداً اضافه می‌کند خودکار شناسایی می‌شوند.

بیشتر اپلیکیشن‌ها فقط همین را لازم دارند - از بلوک اول زیر استفاده کنید و همان‌جا بایستید.

روش کنترل‌شده (بلوک دوم): فقط اگر می‌خواهید خود React قیمت را نشان دهد و صفحه را عوض کند. در این صورت:

• در Next.js، 'use client' را در خط ۱ فایل بگذارید وگرنه ساخت شکست می‌خورد.
• فقط داخل useEffect به window.AppMintIAP دست بزنید - در بدنهٔ کامپوننت روی سرور اجرا می‌شود که window در آن وجود ندارد.
• onChange(fn) فوراً وضعیت را به شما می‌دهد و دوباره در هر تغییر، و تابع لغو اشتراکی را که React می‌خواهد برمی‌گرداند.
• در Next.js به‌صورت خروجی ایستا بسازید: output: 'export' در next.config.js.

// ── EASY WAY — just JSX, nothing else ──────────────────────────
export default function Shop() {
  return (
    <>
      <button data-iap-buy="level_pack_2"
              data-iap-label="Levels 11-20 — {price}"
              data-iap-owned="✓ Unlocked">Levels 11-20</button>

      <div data-iap-show="level_pack_2" hidden>🎉 Levels 11-20 are yours!</div>
    </>
  );
}


// ── CONTROLLED WAY — React draws everything ───────────────────
'use client';                       // Next.js: must be line 1
import { useEffect, useState } from 'react';

export default function Shop() {
  const [iap, setIap] = useState({ available: false, products: {} });

  useEffect(() => {
    if (typeof window === 'undefined' || !window.AppMintIAP) return;
    window.AppMintIAP.start({
      plans: [{ id: 'level_pack_2' }, { id: 'remove_ads_monthly' }]
    });
    return window.AppMintIAP.onChange(setIap);
  }, []);

  if (!iap.available) return null;   // outside the app there is nothing to buy

  const levels = iap.products?.level_pack_2;   // always optional-chain
  return levels?.owned
    ? <p>🎉 Levels 11-20 are yours!</p>
    : <button onClick={() => window.AppMintIAP.buy('level_pack_2')}>
        Levels 11-20 {levels?.price}
      </button>;
}

10بررسی سریع در مرورگر#

صفحهٔ خود را در یک مرورگر معمولی باز کنید (Chrome روی کامپیوتر یا گوشی).

باید دکمهٔ خرید را ببینید که آنجا است و کاری نمی‌کند، و بخش پولی شما هنوز پنهان است. هر دو درست‌اند: بیرون از اپلیکیشن چیزی برای خرید نیست، پس چیزی به‌طور اتفاقی خریده نمی‌شود.

داخل اپلیکیشن کاملاً صفحهٔ دیگری است: دکمه قیمت واقعی را می‌گیرد، صفحهٔ پرداخت Google را باز می‌کند و وقتی خریدار مالک شد خودش را پنهان می‌کند. وب‌سایت شما در هر دو حالت برای بازدیدکنندگان عادی طبق معمول کار می‌کند.

می‌خواهید پیشنهاد در وب کاملاً ناپدید شود؟ آن را در <div data-iap-container hidden> بپیچید - آن پوشش فقط داخل اپلیکیشن آشکار می‌شود.

11مرحلهٔ ۳ - خریدها را در STEPPER روشن کنید#

⚠️ این را رد نکنید. اگر رد کنید دکمه‌هایتان باز هم ظاهر می‌شوند، اما هر زدن پاسخ «In-app purchases are not enabled in this app.» می‌دهد و پولی نمی‌گیرید.

STEPPER همان صفحه‌های Step 1 ← Step 2 ← Step 3 است که برای ساخت اپلیکیشن استفاده می‌کنید. خریدها در STEPPER STEP 3 هستند.

به ترتیب انجام دهید:

1. stepper را باز کنید و به STEPPER STEP 3 بروید (صفحه‌ای که Ads، Notifications و Permissions دارد).

STEPPER STEP 3 — what to set

  Ads ......................... ON  (needed to see the card below)
  💰 Sell In-App Products ..... ON  ← REQUIRED for selling anything

  Selling ad removal too?
  Remove Ads (IAP) ............ ON
  Play Store Product ID ....... remove_ads_monthly
         (two plans) .......... remove_ads_monthly,remove_ads_lifetime
  License Key ................. paste from Play Console

  Export ...................... AAB  (not APK)

12مرحلهٔ ۴ - اپلیکیشن خود را روی Google Play بگذارید#

در Play Console خود (وب‌سایتی که توسعه‌دهندگان اپلیکیشن‌هایشان را مدیریت می‌کنند):

1. «Create app» ← نام و پرسش‌های پایه را پر کنید.
2. در منوی سمت چپ: «Testing» ← «Internal testing» ← «Create new release» ← فایل AAB را بارگذاری کنید ← «Save» و منتشر کنید.
3. همچنان در Internal testing ← تب «Testers» ← Gmail خودتان را اضافه کنید ← لینک «join» را برای بعد کپی کنید.

Internal testing یک محیط خصوصی است - هنوز هیچ‌کس اپلیکیشن شما را نمی‌بیند. برای این است که خودتان بتوانید پیش از عمومی شدن خریدها را امتحان کنید.

Play Console را باز کنید ←

13مرحلهٔ ۵ - محصول خود را بسازید و قیمت را تعیین کنید#

حالا به Google بگویید چه چیزی می‌فروشید. اینکه از کدام منو استفاده کنید بستگی دارد مشتری یک‌بار پرداخت می‌کند یا هر ماه.

یک‌بار پرداخت (مرحله‌ها، پرو، سکه، حذف دائمی تبلیغات)

1. Play Console ← اپلیکیشن شما ← «Monetize» ← «Products» ← «In-app products».
2. «Create product».
3. Product ID: دقیقاً همان شناسه‌ای را که در صفحه‌تان است تایپ کنید - level_pack_2. همان املا، همان حروف بزرگ و کوچک. Google هرگز اجازه نمی‌دهد آن را تغییر دهید یا دوباره استفاده کنید.
4. Name: آنچه خریداران می‌بینند، مثلاً «Levels 11-20». Description: یک خط.
5. قیمت را به ارز خودتان تعیین کنید - Google آن را برای هر کشور تبدیل می‌کند.
6. «Activate» را بزنید.

هر ماه (حذف ماهانهٔ تبلیغات، اشتراک همهٔ مرحله‌ها)

1. Play Console ← «Monetize» ← «Products» ← «Subscriptions».
2. «Create subscription». Product ID: remove_ads_monthly.
3. ذخیره کنید، سپس یک BASE PLAN اضافه کنید: نوع «Auto-renewing»، دورهٔ صورتحساب «Monthly»، قیمت شما.
4. روی base plan و روی خود اشتراک «Activate» را بزنید. اگر یکی را جا بیندازید، اپلیکیشن شما آن را نمی‌بیند.

برای هر شناسه‌ای که استفاده کردید تکرار کنید. کد صفحهٔ شما تغییر نمی‌کند - اپلیکیشن از Google می‌پرسد هر شناسه از کدام نوع است.

ماهانه *و* سالانه می‌خواهید؟ دو اشتراک جداگانه بسازید (all_levels_monthly و all_levels_yearly) به‌جای دو base plan داخل یک اشتراک. یک اشتراک با چند base plan همیشه اولی را ارائه می‌دهد، بدون راهی برای انتخاب.

هر قیمتی را بعداً در Play Console تغییر دهید - اپلیکیشن شما خودش قیمت جدید را نشان می‌دهد، بدون نیاز به ساخت دوباره.

14مرحلهٔ ۶ - آزمایش کنید (از شما پولی کم نمی‌شود)#

1. Play Console ← منوی چپ «Setup» ← «License testing» ← Gmail خود را به فهرست آزمایش‌کنندگان اضافه کنید.
2. روی گوشی: لینک join مربوط به internal-testing را از مرحلهٔ ۴ باز کنید، بپذیرید، و اپلیکیشن را از Play Store نصب کنید.
3. اپلیکیشن را باز کنید. دکمهٔ خرید شما با قیمت واقعی ظاهر می‌شود.
4. روی آن بزنید - صفحهٔ پرداخت Google باز می‌شود و می‌گوید «Test card, always approves». بخرید. محتوای پرو شما ظاهر می‌شود. چیزی پرداخت نمی‌کنید.
5. بررسی جایزه: اپلیکیشن را حذف و دوباره نصب کنید - محتوای پرو هنگام راه‌اندازی خودبه‌خود باز می‌شود. این Google است که خرید را بازیابی می‌کند.

⚠️ اگر APK را مستقیم نصب کنید (sideload) و نه از Play Store، دکمهٔ خرید ظاهر نمی‌شود. این عادی است - همیشه از طریق لینک Play Store آزمایش کنید.

15مرحلهٔ ۷ - انتشار و دریافت پول#

1. وقتی آزمایش خوب بود: Play Console ← «Production» ← با همان AAB یک انتشار بسازید ← منتشر کنید. (اپلیکیشن‌های بار اول از بررسی Google می‌گذرند - معمولاً چند روز.)
2. کاربران داخل اپلیکیشن شما می‌خرند ← Google پول را جمع می‌کند.
3. Google هر ماه به حساب بانکی شما می‌پردازد (Play Console ← «Payments profile»). Google کارمزد استاندارد خود را نگه می‌دارد (۱۵٪ برای بیشتر توسعه‌دهندگان). AppMint چیزی نگه نمی‌دارد.

برای افزودن محصولات بیشتر بعداً: شناسهٔ جدید را در کد صفحه اضافه کنید، یک‌بار دوباره بسازید و شناسه را در Play Console بسازید. تغییر قیمت هرگز به ساخت دوباره نیاز ندارد.

16اگر چیزی کار نکرد#

اپلیکیشن شما به‌جای شکست بی‌صدا، می‌گوید چه مشکلی پیش آمده. پیامی را که می‌بینید پیدا کنید:

«In-app purchases are not enabled in this app.»
← هنگام ساخت، «💰 Sell In-App Products» در STEPPER STEP 3 خاموش بود. آن را روشن کنید و دوباره بسازید.

«This item is not available on Google Play yet.»
← Google آن شناسه را نمی‌شناسد. حرف‌به‌حرف با Play Console مقایسه کنید، مطمئن شوید محصول ACTIVE است (برای اشتراک، base plan و اشتراک هر دو باید فعال باشند)، و مطمئن شوید اپلیکیشن را از لینک آزمایش‌کنندهٔ Play نصب کرده‌اید.

«Google Play could not start the payment.»
← اپلیکیشن از Play Store نصب نشده بود، یا با کلیدی غیر از آنچه بارگذاری کردید امضا شده بود.

«Payment pending - this unlocks automatically once Google confirms.»
← کاری لازم نیست. روش‌های پرداخت کند (کوپن نقدی، برخی UPI) چند دقیقه طول می‌کشند؛ باز شدن خودبه‌خود می‌رسد، حتی پس از راه‌اندازی مجدد اپلیکیشن.

اصلاً هیچ پیامی نیست، با زدن هیچ اتفاقی نمی‌افتد
← تقریباً همیشه غلط تایپی در data-iap-buy است، یا اپلیکیشن از Play نصب نشده است. هر دلیل دیگری یکی از پیام‌های بالا را نشان می‌دهد.

پرداخت انجام شد اما تبلیغات هنوز هستند
← آن شناسهٔ محصول در STEPPER STEP 3 ← «Remove Ads (IAP)» ← «Play Store Product ID» نیست. آن را اضافه کنید (چند مورد را با کاما جدا کنید) و دوباره بسازید.

دکمهٔ خرید هرگز در اپلیکیشن ظاهر نمی‌شود
← «💰 Sell In-App Products» هنگام ساخت خاموش بود. در مرورگر معمولی دکمه‌ها عمداً پنهان‌اند - بیرون از اپلیکیشن چیزی برای خرید نیست.

بعد از بستن صفحهٔ پرداخت Google هیچ اتفاقی نیفتاد
← این یک لغو عادی است. دوباره بزنید و پرداخت را کامل کنید.

قیمت قدیمی به نظر می‌رسد
← Play قیمت‌ها را چند ساعت روی دستگاه ذخیره می‌کند. نصب تازه همیشه قیمت جدید را نشان می‌دهد.

17React، Next.js یا JavaScript ساده#

React و Next.js به چیز خاصی نیاز ندارند. برچسب‌های بالا فقط نشانه‌گذاری‌اند، پس همان یک خط آنجا هم کار می‌کند - بدون useState، بدون useEffect، بدون 'use client':

<button data-iap-buy="pro_unlock"

      data-iap-label="Unlock Pro — {price}">Unlock Pro</button>

دکمه‌هایی که React بعداً سوار می‌کند خودکار پیدا می‌شوند و سوار شدن دوباره بی‌خطر است. در Next.js به‌صورت خروجی ایستا بسازید (output: 'export').

کد را به برچسب‌ها ترجیح می‌دهید؟ یک خط همین کار را می‌کند:

AppMintIAP.sell('pro_unlock', '#buy-btn');

آرگومان سوم اختیاری: {label:'Unlock Pro - {price}', owned:'✓ Unlocked', show:'#thanks', hide:'.upsell'}. برای هر محصول یک بار صدا بزنید.

فقط اگر می‌خواهید خود React قیمت را بکشد - در غیر این صورت این را رد کنید:

const [iap, setIap] = useState({ available: false, products: {} });

useEffect(() => {

if (typeof window === 'undefined' || !window.AppMintIAP) return;
window.AppMintIAP.start({ plans: [{ id: 'pro_unlock' }] });
return window.AppMintIAP.onChange(setIap);

}, []);

const pro = iap.products?.pro_unlock; // همیشه optional-chain

if (!iap.available) return null; // بیرون از اپلیکیشن چیزی برای خرید نیست
if (pro?.owned) return <p>Thanks!</p>;
return <button onClick={() => window.AppMintIAP.buy('pro_unlock')}>

       Unlock Pro {pro?.price}
     </button>;

دو عادت جلوی خراب شدن این را می‌گیرند:

1. مالکیت را برای هر محصول جداگانه بخوانید - iap.products?.<id>?.owned. iap.owned در سطح بالا یعنی «چیزی مالکیت شده» و روزی که محصول دوم بفروشید معنایش عوض می‌شود.
2. کل مسیر را با optional chaining بنویسید تا فیلدی که انتظارش را نداشتید هرگز هنگام رندر React خطا ندهد.

onChange فوراً و در هر تغییر {available, adFree, owned, ownedIds, products} را به شما می‌دهد و یک تابع لغو اشتراک برمی‌گرداند - پس خریدار بازگشتی از همان رندر اول قفلش باز است. در Next.js 'use client' را به‌عنوان خط ۱ اضافه کنید و با output: 'export' بسازید.

همچنین: AppMintIAP.available، .isOwned(id)، .owned()، .buy(id)، .state()، .refresh(). برچسب‌های data-iap-buy در JSX هم کار می‌کنند، و دکمه‌هایی که React بعداً سوار می‌کند خودکار شناسایی می‌شوند.

ترجیح می‌دهید خودتان مستقیم با bridge خام کار کنید؟ همهٔ موارد بالا روی این‌ها ساخته شده‌اند:

• iap.isOwned(id) - درست/نادرست فوری، آفلاین کار می‌کند
• iap.getOwnedProducts() - آرایهٔ JSON از همهٔ شناسه‌های مالکیت‌شده
• iap.getProducts(reqId, idsJson) - قیمت‌های زنده؛ نتیجه به‌صورت رویداد 'appmint:products' می‌رسد {requestId, products:[{productId, title, price, currency, type, owned}]}
• iap.purchase(id) - محصولات یک‌باره و اشتراک‌ها (به‌صورت خودکار تشخیص داده می‌شود)
• رویدادها: 'appmint:purchase' {productId} (فقط اینجا اعطا کنید - زدن روی چیزی که از قبل مالک آن هستید دوباره آن را فعال می‌کند)، 'appmint:owned-changed' {products} (بازیابی هنگام راه‌اندازی تمام شد، یا بازپرداخت چیزی را برداشت - مالکیت را دوباره بخوانید)،'appmint:purchase-failed' {reason: disabled | not_found | billing_error | pending}

فقط یک ارتقای «حذف تبلیغات» می‌فروشید؟ به‌جای آن از جفت داخلی ساده‌تر استفاده کنید - در مرحلهٔ ۳ ویزارد «Remove Ads (IAP)» را فعال کنید:

var iap = window.WebToApk;

if (iap && !iap.isPremium()) {
  showRemoveAdsButton(function onTap() {
    iap.startRemoveAdsPurchase();
  });
}

window.addEventListener('appmint:premium', function (e) {
  if (e.detail.premium) hideRemoveAdsButton();
});

1ساخت محصول مدیریت‌شده (Managed Product)#

در داشبورد Google Play Console خود:

• به «Monetization» > «In-app products» بروید
• روی «Create product» بزنید
• یک Product ID وارد کنید (مثلاً «remove_ads_premium»)
• یک Name (مثلاً «Remove All Ads») و Description تعیین کنید
• قیمت را تعیین کنید و روی «Save» بزنید
• روی «Activate» بزنید تا برای آزمایش در دسترس شود

حذف تبلیغات را به‌صورت اشتراک می‌فروشید؟ آن را زیر «Monetization» > «Subscriptions» با base plan تمدیدشونده بسازید، و هم base plan و هم اشتراک را فعال کنید. بدون‌تبلیغ بودن تا وقتی اشتراک فعال است ادامه دارد، و وقتی منقضی شود تبلیغات خودکار برمی‌گردند.

Play Console را باز کنید ←

2کلید مجوز خود را بگیرید#

Google Play برای تأیید امن خریدها به یک کلید عمومی RSA نیاز دارد.

در Play Console:

• به «Monetization» > «Monetization setup» بروید
• زیر «Licensing»، «Base64-encoded RSA public key» را کپی کنید
• ⚠️ مهم: بعداً باید این را در Generator جای‌گذاری کنید.

Example Key Format:
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...

3تنظیم در WebToApk Generator#

در اپلیکیشن generator:

1. کلید «Remove Ads (IAP)» را در مرحلهٔ ۳ فعال کنید
2. دقیقاً همان «Product ID» را که در مرحلهٔ ۱ ساختید وارد کنید
3. «Base64 License Key» خود را از مرحلهٔ ۲ جای‌گذاری کنید
4. APK/AAB خود را تولید کنید

بیش از یک طرح بدون تبلیغ ارائه می‌دهید (مثلاً اشتراک ماهانه و باز کردن دائمی یک‌باره)؟ هر Product ID را در همین یک فیلد بگذارید و با کاما جدا کنید - مالکیت هر یک از آن‌ها تبلیغات را حذف می‌کند. اولین شناسهٔ فهرست همان است که گزینهٔ منوی داخلی «Remove Ads» می‌خرد، پس طرح پیش‌فرض خود را اول بگذارید.

Product ID: remove_ads_premium

Two plans:
remove_ads_monthly,remove_ads_lifetime

4تنظیم License Testers#

برای آزمایش خرید بدون خرج کردن پول واقعی:

• در Play Console به «Setup» > «License testing» بروید
• آدرس Gmail خود را به فهرست «License testers» اضافه کنید
• مطمئن شوید «License response» روی «RESPOND_NORMALLY» تنظیم شده است

Setup License Testers ←

5در Internal یا Closed Track آزمایش کنید#

خریدهای درون‌برنامه‌ای فقط وقتی کار می‌کنند که اپلیکیشن از طریق Play Store نصب شده باشد (مسیرهای Testing):

1. AAB تولیدشدهٔ خود را در مسیر «Internal Testing» یا «Closed Testing» بارگذاری کنید
2. لینک join آزمایش‌کنندگان را با حساب‌های آزمایشی خود به اشتراک بگذارید
3. اپلیکیشن را از Play Store دانلود کنید
4. برای آزمایش جریان، دکمهٔ «Remove Ads» را در اپلیکیشن خود بزنید!

Note: Purchases will show a 'Test instrument, always approves' message for license testers.