خانه
XtreamUIPro

آموزش

اتصال یک فروشگاه با کانکتور

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

در پایان سفارشی که روی پلتفرم شما پرداخت می‌شود لاین می‌سازد و هر پرداخت آن را تمدید می‌کند، بدون داشبورد. به یک حساب پارتنر (ریسلر) با کردیت و بسته‌هایی که می‌تواند بفروشد، و پلتفرمی با کانکتور نیاز دارید — WHMCS، Blesta، WISECP، HostBill، ClientExec، FOSSBilling، Paymenter، WordPress با WooCommerce یا Easy Digital Downloads، Odoo، PrestaShop، OpenCart، Magento، Dolibarr، ERPNext، یا Shopify، Upmind و Invoice Ninja از طریق پل وب‌هوک.

ساخت کلید API

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

صفحه API Key یک حساب پارتنر: کلید، کلیدهای اضافه برای هر سامانه، وب‌هوک‌ها و فراخوانی‌های اخیر.
صفحه API Key یک حساب پارتنر: کلید، کلیدهای اضافه برای هر سامانه، وب‌هوک‌ها و فراخوانی‌های اخیر.

انتخاب کانکتور

Resources → All Connectors را باز کنید و پلتفرم خود را انتخاب کنید. صفحه آن جزئیات اتصال، گام‌های نصب، دکمه Download، SHA-256 فایل برای تأیید آن، و میزان آزمایش‌شدن آن کانکتور را فهرست می‌کند — بعضی داخل پلتفرم واقعی اجرا شده‌اند، بعضی فقط هسته‌شان آزموده شده است. سورس باز است؛ همان فایل‌ها در سایت کانکتورها منتشر شده‌اند.

صفحه All Connectors: برای هر پلتفرم یک کارت با نسخه و میزان آزمایش‌شدنش.
صفحه All Connectors: برای هر پلتفرم یک کارت با نسخه و میزان آزمایش‌شدنش.

نصب آن روی پلتفرم شما

چک‌سام را تأیید کنید و فایل را همان‌جا که صفحه کانکتور می‌گوید نصب کنید: پوشه ماژول WHMCS، Blesta یا FOSSBilling، آپلود افزونه WordPress، پوشه addons در Odoo، نصب‌کننده افزونه OpenCart و غیره. پل وب‌هوک برای Shopify، Upmind و Invoice Ninja یک برنامه کوچک PHP است که خودتان میزبانی می‌کنید. کانکتور فقط با کلید شما Reseller API را صدا می‌زند: هر کاری حساب شما بتواند می‌تواند بکند، بیشتر نه.

صفحه کانکتور WHMCS: جزئیات اتصال، گام‌های نصب، دانلود و SHA-256 آن.
صفحه کانکتور WHMCS: جزئیات اتصال، گام‌های نصب، دانلود و SHA-256 آن.

پیکربندی آن

در تنظیمات کانکتور آدرس سرور API (مسیر /reseller/v1 آن) و کلید را وارد کنید، سپس هر محصول پلتفرم خود را به بسته‌ای که گروه شما می‌تواند بفروشد نگاشت کنید. قیمت‌ها و پرداخت روی پلتفرم شما می‌مانند: پنل پولی نمی‌گیرد و درگاه پرداخت ندارد.

ثبت یک سفارش آزمایشی

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

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

افزودن وب‌هوک (اختیاری)

در صفحه API Key برای رویدادهایی که می‌خواهید یک اندپوینت وب‌هوک (آدرس https پلتفرم شما) اضافه کنید: line.created، line.renewed، line.enabled، line.disabled، line.deleted، line.expiring، line.expired، credits.low. هر اعلان با رازی که هنگام ساخت یک بار نشان داده می‌شود (X-Xtream-Signature) امضا می‌شود و هرگز رمز عبور نمی‌برد؛ دکمه Test فوراً یکی می‌فرستد.

موضوعات راهنمای مرتبط

آموزش‌های بعدی