دسترسی با هدفی واضح
مشتری درک میکند که آیا در حال اتصال، استفاده از AI یا تأیید خرید است.
توکن و عملیات از حساب و محدوده موردنظر استفاده میکنند.
ساختن با SHAREAI
به مشتریان انتخاب واضحی درباره استفاده از AI، هزینه اختیاری شما و هر خرید بدهید. یک مسیر پرداخت بسازید که بتوانند آن را درک و کنترل کنند.
تجربهای که طراحی خواهید کرد
پرداخت با ShareAIدسترسی واضح. شرایط پذیرفتهشده. خریدهای تأییدشده.
پیادهسازی شما
مجوز، شرایط پذیرفتهشده و پرداختهای تأییدشده را بهصورت واضح در محصول و پیادهسازی خود نگه دارید.
مشتری درک میکند که آیا در حال اتصال، استفاده از AI یا تأیید خرید است.
توکن و عملیات از حساب و محدوده موردنظر استفاده میکنند.
پیشنهادات قابلفهم منتشر کنید و نسخهای که هر مشتری پذیرفته را پیگیری کنید.
شرایط جدید بهطور مخفیانه مشتری موجود را تغییر نمیدهند.
یک خرید موردنظر ایجاد کنید، وضعیت پرداخت آن را تأیید کنید و پس از آن تحویل دهید.
تلاشهای مجدد، لغو، پرداخت ناموفق و محدودیتها مدیریت میشوند.
آن را به ویرایشگر خود ببرید
راهنمای کامل را با هدف پیادهسازی، ورودیهای مورد نیاز و بررسیهای پذیرش کپی کنید. مثالهای کد، جداول و لینکهای مستندات را با هم نگه دارید.
آماده برای پروژه شما، در فرمت مورد نیاز شما.
بهروزرسانیشده
شما اتصال یک حساب، پرداخت برای استفاده از AI و تأیید خرید محصول را متمایز خواهید کرد.
جایی که شما کار خواهید کرد محصول شما → تجربه پرداخت
Pay with ShareAI به مشتری اجازه میدهد از حساب ShareAI انتخابی خود در برنامه شما استفاده کند. دو جریان صورتحساب متمایز وجود دارد: درخواستهای AI تأمینشده توسط مشتری تحت یک مجوز پذیرفتهشده و خرید محصولی که مشتری در فرآیند پرداخت تأیید میکند. Builder مارکآپ اختیاری یک توافق اضافی در مورد استفاده از AI است.
| اقدام مشتری | چه اتفاقی میافتد | دسترسی مورد نیاز |
|---|---|---|
| اتصال کیف پول | ایجاد یک مجوز برای حساب انتخابشده و شرایط پذیرفتهشده. با کلیک روی Connect هیچ محصولی خریداری نمیشود. | openid بهعلاوه قابلیتهایی که برنامه شما استفاده میکند. |
| ارسال درخواست AI | از اعتبارهای AI واجد شرایط حساب مجاز و شرایط استفاده پذیرفتهشده استفاده میکند. | دسترسی استنتاج قابل اعمال؛ monetization_gateway برای شرایط مارکآپ پذیرفتهشده Builder. |
| تأیید خرید یک محصول | مبلغ خرید خاص تنها پس از تأیید مجاز کسر میشود. | payments و یک درخواست پرداخت موفق. |
نمونه قرار ملاقات JamZY مسیر استفاده از AI را نشان میدهد. این شامل پرداخت در فروشگاه نیست، هیچ محدوده پرداختی درخواست نمیکند و ادعا نمیکند که اتصال یک اشتراک را خریداری میکند. از فصلهای باقیمانده زمانی استفاده کنید که آن تجربه جداگانه را اضافه میکنید.
دکمه و متن محصول شما نشان میدهد که آیا مشتری در حال اتصال، استفاده از AI یا تأیید خرید است.
شما از حساب پرداختی مورد نظر قبل از استفاده از آن برای یک عملیات، اجازه میگیرید.
جایی که شما کار خواهید کرد Console → Use Cases → مجوز مشتری
payments برای پرداخت محصول، inference برای AI با هزینه شبکه و monetization_gateway برای یک مارکآپ AI تأییدشده استفاده کنید. فقط قابلیتهایی را درخواست کنید که برنامه واقعاً استفاده میکند.یک شناسه مشتری (client ID) پلتفرم را شناسایی میکند. یک توکن دسترسی نمایانگر مجوز مشتری پذیرفتهشده است. یک نسخه قرارداد شرایط صورتحساب را ثبت میکند. هیچکدام از اینها بهتنهایی اثبات نمیکند که پرداخت محصول خاصی تأیید شده است.
توکن متعلق به مشتری مورد نظر است و شامل مجوزهای عملیات شما است که قصد انجام آن را دارید.
شما شرایط استفاده واضحی منتشر خواهید کرد که مشتری میتواند آنها را بررسی و بپذیرد.
جایی که شما کار خواهید کرد برنامه → اشتراکها
در Subscriptions، پیشنهادهایی با نامهای واضح ایجاد کرده و هزینه اضافی AI را توضیح دهید. شناسه اشتراک تولید میشود، فقط خواندنی است و به برنامه شما محدود میشود. این پیشنهادها در میان مشتریان پلتفرم برنامه به اشتراک گذاشته میشوند، بنابراین شما پیشنهاد تجاری متفاوتی برای وب و اندروید نگهداری نمیکنید.
surcharge را برای این پیشنهاد تنظیم کنید.از Estimate برای مقایسه هزینه شبکه، هزینه اضافی و درآمد سازنده برای مدل انتخابشده استفاده کنید. یک پیشنویس بازبینیشده را بهعنوان نسخه بعدی قرارداد منتشر کنید. مشتریان آن نسخه را در طول مجوز میپذیرند؛ یک پیشنهاد منتشرشده با یک توافقنامه مشتری پذیرفتهشده یکسان نیست.
اگر فقط به payments محصول نیاز دارید، از جریان قرارداد دسترسی پرداخت رایگان موجود استفاده کنید و به جای ایجاد یک مارکآپ Builder، از آن بهره ببرید. قیمتها و بازههای زمانی اشتراک ثابت توسط ویرایشگر پیشنهاد استفاده فعلی پیکربندی نمیشوند؛ یک پیشنهاد AI را به عنوان صورتحساب خودکار دورهای تفسیر نکنید.
پیشنهاد شما بهطور دقیق توضیح میدهد که چه چیزی به هزینه AI اضافه شده است. رضایت مشتری نشاندهنده همان شرایط منتشرشده است.
شما یک قرارداد جدید معرفی خواهید کرد و شرایطی را که هر حساب پذیرفته است پیگیری خواهید کرد.
جایی که شما کار خواهید کرد اشتراکها → قراردادها
تغییرات را در پیشنویس قرارداد بعدی آماده کنید. مجوزهای موجود اشتراک و نسخه پذیرفتهشده خود را حفظ میکنند تا زمانی که مشتری جایگزینی را بپذیرد. تعداد حسابها و توزیعها را در نمای کلی اشتراک مقایسه کنید بهجای اینکه فرض کنید هر حساب از آخرین نسخه استفاده میکند.
به مشتریان بگویید چه تغییراتی رخ داده است و آنها را از طریق جریان رضایت برای پذیرش نسخه جدید در صورت نیاز ارسال کنید. یک توکن تازه نمیتواند پذیرش را ایجاد کند. حفظ قراردادهای پذیرفتهشده، انتقال پیشفرض است. انتخاب برای نیاز به رضایت مجدد قبل از اقدامات بیشتر، دسترسی موجود را عمداً متوقف میکند تا زمانی که مشتری شرایط جدید را تأیید کند؛ تأثیر آن را قبل از انتشار بررسی کنید. هر کاهش مجاز باید از قوانین قرارداد پذیرفتهشده پیروی کند؛ افزایش هزینه نیاز به تأیید مشتری دارد.
نمای سطح برنامه و مرز هویت را جدا نگه دارید. شناسههای مشتری خاص پلتفرم حتی زمانی که نمای کلی تجاری کل برنامه را جمعآوری میکند، به زمینه مشتری خود محدود میمانند.
شما میتوانید شناسایی کنید که هر حساب کدام قرارداد را پذیرفته است و توضیح دهید که چگونه میتواند به قرارداد بعدی منتقل شود.
شما یک خرید موردنظر ایجاد خواهید کرد، تأییدیه دریافت خواهید کرد و پرداخت را قبل از تحویل تأیید خواهید کرد.
جایی که شما کار خواهید کرد بکاند شما → ShareAI پرداخت → تأیید پرداخت
این فصل مثال قرار ملاقات را با خرید محصول جداگانه گسترش میدهد. آن را فقط پس از فعال کردن پرداختها و دریافت توکن مشتری با آن دامنه اجرا کنید. سفارش و وضعیت پرداخت را در بکاند خود نگه دارید.
# Real payment request: use scoped test access and an intentional amount.
curl --fail-with-body 'https://api.shareai.now/api/v1/console/builder/payments' \
-H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: YOUR_UNIQUE_ORDER_REFERENCE' \
--data '{"title":"JamZY appointment preparation pack","amount":"1.00"}'curl --fail-with-body --get \
'https://api.shareai.now/api/v1/console/builder/payments' \
-H "Authorization: Bearer $SHAREAI_ACCESS_TOKEN" \
--data-urlencode "id=$SHAREAI_PAYMENT_ID"| وضعیت پرداخت | آنچه محصول شما باید انجام دهد |
|---|---|
| در انتظار | نشان دهید که تأیید مشتری هنوز موردنیاز است. هنوز انجام ندهید. |
| پرداخت میشوید | با سفارش سرور خود تأیید کنید، سپس یکبار انجام دهید. |
| ردشده | به تصمیم احترام بگذارید؛ بگذارید مشتری انتخاب کند که آیا خرید دیگری را امتحان کند یا خیر. |
| منقضیشده | وقتی مشتری میخواهد دوباره امتحان کند، یک درخواست جدید با یک کلید ایدموتنسی جدید ایجاد کنید. |
فقط از یک URL پرداخت که توسط API معتبر بازگردانده شده است استفاده کنید و آن را با سیاست مقصد مجاز یکپارچهسازی خود تأیید کنید. پیام موفقیت بازگشت به برنامه شواهد پرداخت نیست. پرداختکننده نمیتواند از حساب Builder خود خرید کند.
اگر از یک قرارداد اشتراک با قیمت ثابت موجود پشتیبانی میکنید، API پرداخت میتواند از شرایط پذیرفتهشده آن برای یک دوره بهصراحت تأییدشده استفاده کند. یک قیمت تکرارشونده ساختگی ارسال نکنید یا دوره جدیدی را بهصورت مخفیانه شارژ نکنید. JamZY نمونه قرار ملاقات قابل دانلود آن افزونه را پیادهسازی نمیکند.
هیچ سفارشی تحویل داده نمیشود تا زمانی که بکاند شما پرداخت را تأیید کند، و تکرار جریان تأیید نمیتواند همان سفارش را دوبار تحویل دهد یا بدهی ایجاد کند.
شما محدودیتهای اعتباری و قطع ارتباط را بدون شارژهای تکراری یا تغییرات غیرمنتظره حساب مدیریت خواهید کرد.
جایی که شما کار خواهید کرد برنامه شما → بازیابی صورتحساب
استفاده از AI و خرید محصولات قوانین اعتباری واجد شرایط متفاوتی دارند. ممکن است یک حساب دارای اعتبارات واجد شرایط AI باشد که نمیتواند برای یک محصول پرداخت کند. کمبود بودجه و محدودیتهای هزینهکرد به ازای هر برنامه را با استفاده از خطای API و مقصد صورتحساب مشتری مدیریت کنید.
به مشتری حساب پرداختی انتخابشده، عملی که شکست خورده و مسیری برای مدیریت اعتبارات یا محدودیتها را نشان دهید. مشتری کنترل سقف خود را دارد؛ مالک برنامه نمیتواند آن را افزایش دهد. برای موفقیت در شارژ، بهصورت مخفیانه از یک حساب سازمانی به یک حساب شخصی تغییر ندهید.
قطع ارتباط باید مجوز مربوطه را لغو کرده و جلسه محلی را پاک کند. این کار درخواستهای مجاز آینده را متوقف میکند؛ اما خریدی که قبلاً تأیید شده است را لغو نمیکند یا بهطور خودکار یک تعهد پرداخت جداگانه را لغو نمیکند. شکست در تازهسازی، لغو مجوز و انقضای پرداخت نیاز به پیامهای بازیابی متمایز دارند.
خطاهای کمبود اعتبار و محدودیت مشتری را مطلع و در کنترل نگه میدارند، بدون سفارش تکراری تصادفی یا تغییر پرداختکننده.
شما مسیر موفقیتآمیز و موارد شکست آن را قبل از گنجاندن پلتفرم در انتشار آزمایش خواهید کرد.
جایی که شما کار خواهید کرد تنظیمات OAuth → تأیید
از لیست آزمایشکنندگان برنامه و یک حساب پرداختی واجد شرایط که با Builder متفاوت است استفاده کنید. حداکثر پنج جایگاه آزمایشکننده از جمله دعوتنامههای در انتظار وجود دارد. تأیید نقطه پایانی واقعی و دامنه را برای هر پلتفرم گنجاندهشده در انتشار کامل کنید.
inference یا monetization_gateway و تماس API پرداخت موفق مورد نیاز برای payments آزمایش کنید. یک درخواست پرداخت ممکن است در حالت انتظار باشد بدون اینکه بدهی انجام شود؛ یک آزمایش کامل پرداخت همچنین تأیید صریح و پرداختشده را بررسی میکند.یکپارچهسازی شما دسترسی پذیرفتهشده، شرایط پذیرفتهشده، پرداخت درخواستشده و پرداخت تأییدشده را متمایز میکند و مسیر شکست برای هر یک را مدیریت میکند.
حساب شخصی یا سازمانی را انتخاب کنید که مالک ثبتنام برنامه خواهد بود قبل از درخواست. سازمانها میتوانند درخواست را قبل از تأیید ارسال کنند، اما تأیید کارکنان به تنهایی دسترسی را فعال نمیکند. تأیید ایمیل سازمان و شرکت را از چکلیست شروع در Console تکمیل کنید. یک سازمان تأیید شده تا زمانی که هر دو بررسی کامل نشوند، در حالت انتظار تأیید باقی میماند. Builder، Provider و Creator برنامهها از این قانون پیروی میکنند.
مشاهده قیمتگذاری Monetization Gateway · کاوش کنید ShareAI for Startups · محدودهها و مجوزها
شرایط و ضوابط عمومی، سیاست حفظ حریم خصوصی و دستورالعملهای حذف شما باید با برنامه مطابقت داشته باشند و بدون نیاز به ورود به سیستم قابل دسترسی باقی بمانند. پذیرش برنامه ShareAI، تأیید Monetization Gateway، مجوز OAuth مشتری و قرارداد صورتحساب پذیرفتهشده تصمیمات جداگانهای هستند. تازهسازی نمیتواند مجوزها را اضافه کند یا شرایط تجاری جدیدی را بپذیرد.
محدوده قدیمی surcharge برای یکپارچهسازیهای موجود همچنان پذیرفته میشود. مثالهای جدید از monetization_gateway استفاده میکنند. فیلدهای سیمی موجود مانند surcharge_bps و surcharge_percentage را بدون تغییر نگه دارید.
مشاهده قیمتگذاری Monetization Gateway · کاوش کنید ShareAI for Startups · محدودهها و مجوزها
هزینههای استاندارد 5% از Builder مارکآپ. برای €2.00 هزینه شبکه AI و یک 10% مارکآپ، مشتری €2.20 پرداخت میکند. ShareAI دریافت میکند €0.01 از €0.20 مارکآپ؛ Builder دارای €0.19 قبل از دریافت رویداد است.
اولین 1,000 درخواستهای تولیدی تسویهشده Monetization Gateway هر ماه تقویمی (UTC) رایگان هستند و در حساب Builder به اشتراک گذاشته میشوند. درخواستهای اضافی هزینه €0.04 به ازای هر 1,000 قبل از تخفیفهای واجد شرایط دارند. یک درخواست تسویهشده یک رویداد ایجاد میکند.
Pay with ShareAI به تنهایی، دسترسی فقط به inference، کلیدهای API حساب عادی و ترافیک مرحلهبندی یا آزمایشی هزینه دریافت رویداد Monetization Gateway را شامل نمیشوند.
ShareAI for Startups یک بودجه ماهانه مشترک برای هزینههای واقعی ShareAI در یک اپلیکیشن تأییدشده ارائه میدهد. سطوح فعلی Launch، Growth و Momentum به ترتیب €1,000، €5,000 و €10,000 در ماه را فهرست میکنند. همان بودجه هزینه درصدی ShareAI روی Builder مارکآپ و Event Ingestion قابلصورتحساب را با هم پوشش میدهد. این بودجه مارکآپ ناخالص، سهمیه رویداد رایگان جداگانه یا AI رایگان inference نیست. اولین 1,000 رویداد رایگان حساب آن را مصرف نمیکند.
هزینههای باقیماندهی Event Ingestion از درآمد جدید درخواست Builder پرداخت میشوند، سپس از درآمدهای AI موجود Builder و اعتبارهای AI نامحدود. هزینههای AI مشتری و محصول payments جدا باقی میمانند.
ShareAI میتواند هزینههای خاص اپلیکیشن یا پشتیبانی هزینه را برای یک دوره ثابت یا تا زمان تغییر تأیید کند. شرایط تأییدشده، اعتبار و بودجه مصرفشده اپلیکیشن را در Console بررسی کنید. تغییر سطح یا بازنویسی قیمت، استفاده ماهانه اپلیکیشن را بازنشانی نمیکند.
Launch ورود با ShareAI را اختیاری نگه میدارد. Growth و Momentum آن را الزامی میکنند؛ Momentum همچنین نشان رسمی ShareAI for Startups را در فوتر اپلیکیشن نیاز دارد. ShareAI نشان را بهصورت هفتگی بررسی میکند. تلاشهای تأییدشده برای دور زدن الزامات میتواند منجر به کاهش سطح، حذف از برنامه Startup یا خروج از Marketplace تحت شرایط پذیرفتهشده برنامه شود.
نرخهای سازمانی توسط تیم ShareAI برای حساب Builder پس از توافق بر پیشنهاد شخصیسازیشده تنظیم میشوند. درصد اختصاص دادهشده و نرخ رویداد برای درخواستهای آینده اعمال میشوند.
مشاهده قیمتگذاری Monetization Gateway · کاوش کنید ShareAI for Startups · محدودهها و مجوزها