مستندات وبسرویس

(v1.3)

نیاز به راهنمایی دارید؟

تیم پشتیبانی ما آماده کمک به شماست.

تماس با پشتیبانی

وبسرویس (API) فروش گیفت کارت


وبسرویس گیفت سیتی به شما این امکان را می‌دهد که بدون دغدغه تأمین و مدیریت، فقط روی فروش گیفت کارت و خدمات ما تمرکز کنید و براحتی کسب درآمد کنید! با اتصال وبسرویس به سایت، اپلیکیشن یا ربات تلگرام خود، سفارش‌ها را خودکار ثبت کنید، وضعیت را پیگیری کنید و کدهای فعال‌سازی را آنی به مشتریان تحویل دهید. همچنین، با سیستم مشارکت در فروش (Affiliate)، می‌توانید بدون نیاز به موجودی، از فروش گیفت کارت‌ها درآمد داشته باشید. دسترسی لحظه‌ای به قیمت‌ها و موجودی، تجربه خریدی سریع، بی‌وقفه و سودآور را برای شما و مشتریانتان فراهم می‌کند!

🚀نسخه فعلی v1 : این نسخه شامل تمام قابلیت‌های اصلی مورد نیاز برای ادغام محصولات گیفت‌سیتی با پلتفرم شما است.

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

مزایای وبسرویس

💳

پرداخت آسان

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

🔄

تحویل خودکار

کدهای گیفت‌کارت بلافاصله پس از پردازش سفارش در دسترس قرار می‌گیرند.

📊

گزارش‌های هوشمند

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

📱

ادغام همه‌جانبه

با تمامی پلتفرم‌ها از وب‌سایت و اپلیکیشن موبایل تا ربات‌های تلگرام سازگار است.

نحوه محاسبه قیمت و تخفیف برای همکاران

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

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

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

شروع سریع

برای استفاده از API گیفت‌سیتی، سه مرحله ساده زیر را دنبال کنید:

1

ایجاد API Key

از پنل کاربری خود یک کلید API اختصاصی دریافت کنید

2

شارژ کیف پول

کیف پول خود را برای پرداخت خودکار سفارش‌ها شارژ کنید

3

ادغام با سیستم

با استفاده از کدهای نمونه ما، API را در سیستم خود پیاده‌سازی کنید