בית
XtreamUIPro

מדריך

חיבור חנות באמצעות מחבר

תנו לפלטפורמת החיוב או החנות שלכם ליצור ולחדש קווים בעצמה: מפתח API, המחבר לפלטפורמה שלכם, הזמנת בדיקה, ו-webhooks למה שקורה אחר כך.

בסוף, הזמנה ששולמה בפלטפורמה שלכם יוצרת קו וכל תשלום מחדש אותו, בלי לוח הבקרה. צריך חשבון שותף (מפיץ) עם קרדיטים ומסלולים שמותר לו למכור, ופלטפורמה עם מחבר: WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WordPress עם WooCommerce או Easy Digital Downloads, Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext, או Shopify, Upmind ו-Invoice Ninja דרך גשר ה-webhook.

יצירת מפתח API

היכנסו עם חשבון השותף ופתחו את API Key. מפתח מוצג פעם אחת, בעת יצירתו, אז העתיקו אותו מיד. צרו מפתח נוסף לכל מערכת, עם שם והכתובות שמורשות להשתמש בו, כדי שאפשר יהיה לבטל אחד בלי לגעת באחרים; המחבר צריך מפתח שיכול לכתוב, לכן השאירו את דגל הקריאה בלבד כבוי.

דף API Key של חשבון שותף: המפתח, המפתחות הנוספים לכל מערכת, ה-webhooks והקריאות האחרונות.
דף API Key של חשבון שותף: המפתח, המפתחות הנוספים לכל מערכת, ה-webhooks והקריאות האחרונות.

בחירת המחבר

פתחו את Resources → All Connectors ובחרו את הפלטפורמה שלכם. הדף שלה מפרט את פרטי החיבור, שלבי ההתקנה, כפתור Download, את ה-SHA-256 של הקובץ לאימות, ועד כמה המחבר נבדק: חלקם הורצו בתוך הפלטפורמה האמיתית, באחרים נבדק רק הליבה. הקוד פתוח; אותם קבצים מתפרסמים באתר המחברים.

דף All Connectors: כרטיס אחד לכל פלטפורמה עם הגרסה שלה ועד כמה נבדקה.
דף All Connectors: כרטיס אחד לכל פלטפורמה עם הגרסה שלה ועד כמה נבדקה.

התקנה בפלטפורמה שלכם

אמתו את סכום הביקורת והתקינו את הקובץ במקום שדף המחבר מציין: תיקיית המודולים של WHMCS, Blesta או FOSSBilling, העלאת התוסף ב-WordPress, תיקיית addons של Odoo, מתקין ההרחבות של OpenCart, וכן הלאה. גשר ה-webhook עבור 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 אחרי הזמנת בדיקה: הקו החדש עם המסלול, התפוגה והחיבורים שהמחבר ביקש.

הוספת webhooks (אופציונלי)

בדף API Key הוסיפו נקודת webhook (כתובת https של הפלטפורמה שלכם) לאירועים שאתם רוצים: line.created, line.renewed, line.enabled, line.disabled, line.deleted, line.expiring, line.expired, credits.low. כל הודעה חתומה בסוד שמוצג פעם אחת ביצירה (X-Xtream-Signature) ולעולם לא נושאת סיסמה; כפתור Test שולח אחת מיד.

נושאי עזרה קשורים

המדריכים הבאים