API ساخت کد تخفیف
ساخت کد تخفیف اختصاصی و یکبارمصرف برای مشتری با REST API اینپی فای همراه پارامترها و پاسخ.
این endpoint برای یک تخفیف فعال و یک مشتری، کد اختصاصی میسازد. فراخوانی دوباره با همان discount_identifier_key و app_user_identifier همان کد موجود را فعال و برمیگرداند.
پیش از اتصال API، قواعد تخفیف را در پنل تعریف کنید. راهنمای ساخت و مدیریت کدهای تخفیف تفاوت شناسه و کد، مشتریان مجاز و نحوه استفاده در پرداخت وب را توضیح میدهد.
ساخت کد تخفیف مشتری
پارامترهای درخواست
| پارامتر | نوع | محدودیت |
|---|---|---|
discount_identifier_key | string | الزامی، حداکثر ۱۰۰ کاراکتر، شناسه تخفیف فعال در همان پروژه |
app_user_identifier | string | الزامی، حداکثر ۱۵۰ کاراکتر |
نمونه cURL
پاسخ موفق
خطاها
| وضعیت | دلیل |
|---|---|
422 | یکی از پارامترها وجود ندارد، رشته نیست یا طول مجاز را رد کرده است. |
403 | کلید مجوز discount:generate ندارد. |
500 | تخفیف پیدا نشده یا فعال نیست، یا خطای پیشبینینشده رخ داده است. |
در قرارداد فعلی، تخفیف ناموجود یا غیرفعال بهصورت خطای دامنهای عمومی مدیریت نشده و ممکن است پاسخ 500 ایجاد کند. پیش از فراخوانی از فعالبودن شناسه تخفیف مطمئن شوید.