مدیریت تراکنشها با API وضعیت خرید درون برنامه کافه بازار
در دنیای توسعه اپلیکیشنهای اندرویدی، امنیت پرداخت و تایید صحت خریدها از اهمیت ویژهای برخوردار است. اگر شما از سیستم پرداخت درونبرنامهای کافه بازار استفاده میکنید، حتماً میدانید که اتکا به دادههای سمت کلاینت (اپلیکیشن) به تنهایی کافی نیست. برای جلوگیری از هک و جعل خرید، استفاده از API وضعیت خرید ضروری است. در این مقاله، به بررسی دقیق وبسرویس بررسی وضعیت خرید، مزایا و نحوه پیادهسازی آن میپردازیم. 🚀
چرا به وب سرویس بررسی وضعیت خرید نیاز داریم؟
زمانی که کاربر خریدی را انجام میدهد، یک توکن خرید (Purchase Token) تولید میشود. با این حال، برخی کاربران سودجو ممکن است با ابزارهای تقلب، پاسخهای جعلی به برنامه بفرستند. بنابراین، شما باید این توکن را در سمت سرور خود با API وضعیت خرید کافه بازار چک کنید. این کار باعث میشود تا فقط پس از اطمینان از صحت واریز وجه، محصول یا خدمات را به کاربر ارائه دهید. ✅
مزیتهای استفاده از API وضعیت خرید کافه بازار
استفاده از این وبسرویس برای هر توسعهدهندهای که به دنبال پایداری کسبوکار خود است، مزایای متعددی دارد:
- 🛡️ امنیت بالا: جلوگیری کامل از خریدهای جعلی و اپلیکیشنهای لاکیپچر.
- 📊 دقت در آمار: ثبت دقیق تراکنشها در دیتابیس سرور برای گزارشگیری مالی.
- 🔄 مدیریت بازگشت وجه: اطلاع سریع از وضعیت خریدهای مرجوع شده (Refund).
- 🌐 یکپارچگی: امکان اتصال مستقیم سرور بازی یا اپلیکیشن به پنل توسعهدهندگان بازار.
- 🛠️ کنترل مصرف: تشخیص دقیق اینکه آیا محصول مصرفی (Consumable) استفاده شده است یا خیر.
کاربردهای اصلی این API در اپلیکیشنها
این ابزار در سناریوهای مختلفی به کمک توسعهدهندگان میآید که مهمترین آنها عبارتند از:
- 💰 فروش سکه و ارز مجازی: تایید نهایی قبل از واریز سکه به حساب کاربر در بازیها.
- 🔓 باز کردن مراحل قفل شده: اطمینان از پرداخت هزینه قبل از آزادسازی محتوای ویژه.
- 📅 تمدید اشتراک: چک کردن دورهای وضعیت خرید برای اشتراکهای زمانی.
- 🎁 ارسال هدایای درونبرنامهای: تایید صحت خرید قبل از ارسال آیتم به دیگران.
ساختار فنی درخواست API وضعیت خرید
برای استعلام وضعیت هر خرید، باید یک درخواست GET به آدرس زیر ارسال کنید. توجه داشته باشید که این درخواست حتماً به access_token معتبر نیاز دارد که از طریق OAuth2 دریافت شده است. 🔗
آدرس متد:
https://pardakht.cafebazaar.ir/devapi/v2/api/validate/<package_name>/inapp/<product_id>/purchases/<purchase_token>/
پارامترهای مورد نیاز در URL
در این بخش، متغیرهایی که باید در آدرس جایگذاری شوند را بررسی میکنیم:
- 🔹 package_name: نام بسته (Package Name) اپلیکیشن شما.
- 🔹 product_id: شناسه کالا یا همان SKU محصول تعریف شده در پنل.
- 🔹 purchase_token: توکنی که پس از خرید موفق از سمت بازار به اپلیکیشن ارسال شده است.
تحلیل پاسخ دریافتی (JSON Response)
پس از ارسال درخواست، کافه بازار پاسخی در قالب JSON برمیگرداند. یک نمونه پاسخ موفق به شرح زیر است:
{
"consumptionState": 1,
"purchaseState": 0,
"kind": "androidpublisher#inappPurchase",
"developerPayload": "unique_string",
"purchaseTime": 1414181378566
}
شرح فیلدهای پاسخ
- 🔸 consumptionState: اگر مقدار آن
0باشد یعنی محصول مصرف شده و اگر1باشد یعنی هنوز مصرف نشده است. - 🔸 purchaseState: مقدار
0نشانه خرید موفق و مقدار1نشانه مرجوع شدن (Refund) خرید است. - 🔸 developerPayload: رشته خاصی که هنگام خرید برای پیگیریهای داخلی ارسال کرده بودید.
- 🔸 purchaseTime: زمان دقیق انجام تراکنش به صورت Unix Timestamp (میلیثانیه).
مدیریت خطاها و امنیت تراکنش
اگر درخواستی نامعتبر باشد، سیستم با کد وضعیت 40X پاسخ میدهد. با این حال، مهمترین خطا not_found با کد 404 است.
نکته کلیدی: تنها زمانی که فیلد
errorبرابر باnot_foundباشد، به این معنی است که تراکنش اصلاً وجود ندارد. این موضوع معمولاً نشانه تلاش کاربر برای جعل خرید (Fake Purchase) است. در این شرایط، هرگز نباید محصول را به کاربر تحویل دهید. ⚠️
مراحل ثبتنام و دریافت دسترسی
برای استفاده از این خدمات و مدیریت بهتر تراکنشهای خود، ابتدا باید در سیستمهای واسط یا مستقیم ثبتنام کنید.
- ابتدا به وبسایت ارائه دهنده خدمات API مراجعه کنید.
- حساب کاربری خود را ایجاد و تایید نمایید.
- نام بسته و کلیدهای امنیتی خود را دریافت کنید.
- برای شروع سریع، میتوانید از طریق لینک p.api.ir اقدام به ثبتنام و دریافت مستندات تکمیلی نمایید. 📝
قدم آخر
استفاده از API وضعیت خرید درون برنامه کافه بازار انتخابی هوشمندانه برای حفظ درآمد توسعهدهندگان است. این ابزار نه تنها امنیت پرداخت را بالا میبرد، بلکه مدیریت محصولات مصرفی و مرجوعی را نیز آسان میکند. بنابراین، همین امروز زیرساخت سرور خود را به این API مجهز کنید تا از بروز خسارات مالی جلوگیری نمایید. 💎
آیا در پیادهسازی این وبسرویس با مشکلی مواجه شدهاید؟ نظرات و سوالات خود را در بخش دیدگاهها با ما به اشتراک بگذارید تا کارشناسان ما شما را راهنمایی کنند.