پرش به محتوای اصلی
بازگشت

راهنمای پرداخت در برنامه شما

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

دو روش پرداخت، بسته به اینکه کاربر کجاست

روی وب‌سایت، پرداخت از طریق درگاه بازارپی انجام می‌شود و پول به حساب پذیرندهٔ خودتان می‌رود.

داخل اپلیکیشن اندروید، خرید از طریق «پرداخت درون‌برنامه‌ای بازار» انجام می‌شود؛ این تنها روش مجاز فروش داخل برنامه‌ای است که در بازار منتشر شده، و درصدی از هر فروش سهم بازار است.

لازم نیست بین این دو انتخاب کنید و کد برنامه هم برای هرکدام جدا نوشته نمی‌شود؛ خودِ برنامه در لحظه تشخیص می‌دهد کاربر روی سایت است یا داخل اپلیکیشن.

دو نوع فروش، و اینکه کدام قانون بازار شامل شما می‌شود

اگر چیزی «دیجیتال با قیمت ثابت» می‌فروشید — اشتراک، سکه، جان اضافه، حذف تبلیغات، نسخه حرفه‌ای — داخل اپلیکیشن اندروید باید حتماً از پرداخت درون‌برنامه‌ای بازار استفاده شود. بازار برنامه‌ای را که این کار را نکند منتشر نمی‌کند. روی وب‌سایت همان محصولات از درگاه بازارپی فروخته می‌شوند.

اگر کالا یا خدمت واقعی با قیمت متغیر می‌فروشید — فروشگاه با سبد خرید، سفارش غذا، بلیت، رزرو، شارژ کیف پول — این قانون شامل شما نمی‌شود و هم در وب و هم در اپلیکیشن از درگاه پرداخت استفاده می‌شود. بازار این را می‌پذیرد.

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

حالت آزمایشی: چه چیزی واقعی است و چه چیزی نه

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

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

خرید آزمایشی داخل اپلیکیشن روی همان صفحهٔ پرداخت با پیام «پرداخت آزمایشی است و مبلغی کسر نمی‌شود» مشخص می‌شود. چیزی روی بقیهٔ صفحات برنامه‌تان اضافه نمی‌شود؛ خودتان هم در پنل پرداخت همیشه می‌بینید که هنوز در حالت آزمایشی هستید.

در پیش‌نمایش، درست بالای صفحه و کنار انتخاب اندازهٔ گوشی و تبلت، دکمهٔ «وب‌سایت / اپلیکیشن» هست؛ با آن هر دو مسیر را حتی روی کامپیوتر خودتان امتحان می‌کنید. اگر روی گوشی خودتان تست می‌کنید، کافی است به انتهای آدرس ‎?ab_pay_channel=app‎ را اضافه کنید.

برای فروش روی وب‌سایت چه چیزی لازم است

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

شناسهٔ مقصد (destination): نام حسابی که پول به آن واریز می‌شود و کنار توکن در همان پنل آمده است.

برای گرفتن این دو، باید حساب پذیرندگی بازارپی داشته باشید؛ این کار از سمت خودتان با کافه‌بازار انجام می‌شود و ما نمی‌توانیم آن را کوتاه کنیم.

برای فروش داخل اپلیکیشن چه چیزی لازم است

حساب توسعه‌دهندهٔ بازار و انتشار برنامه در بازار. بدون این، خرید درون‌برنامه‌ای به هیچ شکلی کار نمی‌کند.

نام بستهٔ برنامه: در پنل پرداخت به شما نشان داده می‌شود و باید دقیقاً همان را در پیشخان بازار ثبت کنید. این نام ثابت است و بعداً قابل تغییر نیست.

کلید API پیشخان: از پیشخان بازار ← «API پیشخان بازار» ← «دریافت توکن جدید». با این کلید، هر خرید را روی سرور بررسی می‌کنیم تا خرید جعلی پذیرفته نشود.

کلید عمومی RSA: از بخش «پرداخت درون‌برنامه‌ای» پیشخان. مخفی نیست و برای بررسی اصالت خرید روی دستگاه کاربر استفاده می‌شود.

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

نکته: برای تست پیش از انتشار، بازار اجازه می‌دهد محصول را با قیمت صفر ریال تعریف کنید.

بعد از وارد کردن اطلاعات چه اتفاقی می‌افتد

به‌محض ذخیره و فعال‌سازی، وب‌سایت شما شروع به دریافت پول واقعی می‌کند. نیازی به تغییر کد، پیام دادن دوباره به دستیار یا انتشار مجدد نیست.

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

خریدهای آزمایشی قبلی از همان لحظه بی‌اثر می‌شوند؛ کسی که در حالت آزمایشی چیزی «خریده» بود، آن را نگه نمی‌دارد.

پول همیشه مستقیم به حساب خودتان می‌رود و از حساب ما عبور نمی‌کند.

پول سفارش دقیقاً چه زمانی از حساب مشتری کم می‌شود

وقتی برنامه‌تان سرور دارد (مثل یک فروشگاه)، مشتری برای پرداخت به درگاه می‌رود و بعد مستقیم به دامنهٔ خودتان برمی‌گردد؛ در این مسیر نام «بازار استودیو» به مشتری شما نشان داده نمی‌شود.

تا وقتی سرور شما تأیید نکرده که سفارش کامل شده، مبلغ فقط «نگه داشته» شده و برداشت نشده است. اگر مشتری وسط کار صفحه را ببندد، یا موجودی انبار تمام شده باشد، یا هر خطای دیگری رخ دهد، کل مبلغ به‌صورت خودکار به مشتری برمی‌گردد و شما هیچ کاری لازم نیست بکنید.

به همین دلیل هرگز نباید صرف بازگشتن مشتری به سایت را نشانهٔ پرداخت گرفت. آدرس صفحه را هر کسی می‌تواند دستی تایپ کند؛ تنها تأیید سرور معتبر است. دستیار این را رعایت می‌کند.

دیدن فروش‌ها

در پنل پرداخت، فهرست تراکنش‌ها را می‌بینید: مبلغ، شمارهٔ سفارش، وضعیت و زمان. عمداً چیزی بیش از این نگه نمی‌داریم.

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

اگر درگاه بانکی دیگری دارید

اگر حساب پذیرندگی نزد یک درگاه دیگر (مثلاً سامان‌کیش) دارید و می‌خواهید همان استفاده شود، با ما تماس بگیرید؛ این کار برای هر پروژه جداگانه انجام می‌شود و نیاز به اطلاعات پذیرندگی خودتان دارد.

یک هشدار مهم پیش از تصمیم: اگر محصول شما «دیجیتال با قیمت ثابت» است، استفاده از درگاهی غیر از پرداخت درون‌برنامه‌ای بازار می‌تواند باعث رد شدن برنامه در بازار شود. این انتخاب با شماست، اما بهتر است پیش از شروع کار بدانید.

امنیت اطلاعاتی که به ما می‌دهید

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

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

هر دو توکن در پنل‌های بازار قابل باطل‌کردن و ساخت دوباره هستند.