مصرف خرید درون برنامه ای

متد مصرف خرید درون برنامه ای

برای مصرف خرید درون‌برنامه‌ای اپ خود علاوه بر روش موجود در sdk می توانید از API زیر نیز استفاده کنید:

https://pardakht.cafebazaar.ir/devapi/v2/api/consume/<package_name>/purchases/

متد صدا زدن API باید POST باشد.

در Body ریکوئست باید مقدار توکن خرید به فرمت Json به صورت زیر ارسال شود:

{"token": "<purchase_token>"}

مقادیر داخل پرانتز شکسته – <> – باید با توجه به درخواست جایگزین شوند:

نام	مقدار
package_name	نام بسته‌ای که محصول از آن خریداری شده‌است.
purchase_token	token خرید که پس از خرید از بازار به برنامه فرستاده شده‌است.

توجه کنید که برای استفاده از این متد به access_token معتبر نیاز دارید.

توجه کنید این API فقط برای محصولات یکبار خرید معتبر است و برای محصولات اشتراکی خطای ۴۰۰ برمی‌گرداند.

در صورت موفقیت ، استاتوس کد ۲۰۰ بازگردانده خواهد شد.

در صورتی که به هر دلیل، درخواست معتبر نباشد، پاسخی با کد وضعیت 40X و در قالب JSON دریافت خواهید کرد که دارای یک کلید error با محتوای خطای ایجاد شده‌ و کلید error_desciption با شرحی بیشتر درباره خطا است. به عنوان مثال در صورتی که خرید موردنظر یافت نشود، پاسخ بازگشتی با کد وضعیت 404 و به صورت زیر خواهد بود:

{"error": "not_found",   "error_description": "The requested purchase is not found!",}

در جدول زیر خطاهای ممکن به همراه توضیحات آمده است.

reason	status code	error_description	error
توکن خرید ارسال شده نامعتبر می‌باشد.	404	Invalid token!	invalid_value
مقدار package_name معتبر نیست.	404	Package name is invalid	invalid_value
خرید مورد نظر انجام نشده است.	404	The requested purchase is not found!	not_found
نوع محصول خرید اشتراکی است.	400	Can not consume subscription.	is_subscription
خرید قبلا مصرف شده است.	400	The purchase has already been consumed.	already_consumed
خرید قبلا ریفاند شده است.	400	The purchase has been refunded.	is_refunded