Start
XtreamUIPro

Poradnik

Połącz sklep przez konektor

Pozwól swojemu systemowi rozliczeń lub platformie sklepowej samodzielnie tworzyć i odnawiać linie: klucz API, konektor dla Twojej platformy, zamówienie testowe i webhooki dla tego, co dzieje się dalej.

Na końcu zamówienie opłacone na Twojej platformie tworzy linię, a każda płatność ją odnawia, bez udziału panelu. Potrzebujesz konta partnerskiego (resellera) z kredytami i pakietami, które może sprzedawać, oraz platformy z konektorem — WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WordPress z WooCommerce lub Easy Digital Downloads, Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext albo Shopify, Upmind i Invoice Ninja przez most webhooków.

Utwórz klucz API

Zaloguj się kontem partnerskim i otwórz Klucz API. Klucz jest pokazywany raz, w chwili utworzenia — skopiuj go od razu. Utwórz dodatkowy klucz na każdy system, z nazwą i adresami uprawnionymi do jego użycia, aby jeden dało się odwołać bez ruszania pozostałych; konektor potrzebuje klucza z prawem zapisu, więc zostaw flagę tylko do odczytu wyłączoną.

Strona Klucz API konta partnerskiego: klucz, dodatkowe klucze na system, webhooki i ostatnie wywołania.
Strona Klucz API konta partnerskiego: klucz, dodatkowe klucze na system, webhooki i ostatnie wywołania.

Wybierz konektor

Otwórz Zasoby → Wszystkie konektory i wybierz swoją platformę. Jej strona zawiera dane połączenia, kroki instalacji, przycisk Pobierz, SHA-256 pliku do weryfikacji oraz informację, jak daleko ten konektor był testowany — niektóre działały wewnątrz prawdziwej platformy, inne miały sprawdzony tylko rdzeń. Kod źródłowy jest otwarty; te same pliki są publikowane na stronie konektorów.

Strona Wszystkie konektory: jedna karta na platformę z jej wersją i informacją, jak daleko była testowana.
Strona Wszystkie konektory: jedna karta na platformę z jej wersją i informacją, jak daleko była testowana.

Zainstaluj go na swojej platformie

Zweryfikuj sumę kontrolną i zainstaluj plik tam, gdzie wskazuje strona konektora: folder modułów WHMCS, Blesta lub FOSSBilling, wgrywanie wtyczek WordPress, folder addons w Odoo, instalator rozszerzeń OpenCart i tak dalej. Most webhooków dla Shopify, Upmind i Invoice Ninja to mała aplikacja PHP, którą hostujesz samodzielnie. Konektor tylko wywołuje Reseller API z Twoim kluczem: może zrobić to, co Twoje konto, i nic więcej.

Strona konektora WHMCS: dane połączenia, kroki instalacji, pobranie i jego SHA-256.
Strona konektora WHMCS: dane połączenia, kroki instalacji, pobranie i jego SHA-256.

Skonfiguruj go

W ustawieniach konektora wpisz adres serwera API (jego ścieżkę /reseller/v1) i klucz, a następnie przypisz każdy produkt swojej platformy do pakietu, który może sprzedawać Twoja grupa. Ceny i płatności zostają na Twojej platformie: panel nie przyjmuje pieniędzy i nie ma bramki płatności.

Złóż zamówienie testowe

Zamów produkt w środowisku testowym swojej platformy. Konektor wywołuje create_line z pakietem i identyfikatorem żądania; linia pojawia się w sekcji Linie z czasem trwania pakietu jako datą wygaśnięcia, a Twoja platforma otrzymuje jej dane logowania. Odnowienie wywołuje renew_line z własnym identyfikatorem żądania, więc ponowienie po błędzie sieci nigdy nie obciąży dwa razy. Strona Klucz API pokazuje ostatnie wywołania z akcją, wynikiem, kodem błędu, adresem i nazwą konektora.

Strona Linie po zamówieniu testowym: nowa linia z pakietem, datą wygaśnięcia i połączeniami, o które poprosił konektor.
Strona Linie po zamówieniu testowym: nowa linia z pakietem, datą wygaśnięcia i połączeniami, o które poprosił konektor.

Dodaj webhooki (opcjonalnie)

Na stronie Klucz API dodaj punkt końcowy webhooka (adres https Twojej platformy) dla wybranych zdarzeń: line.created, line.renewed, line.enabled, line.disabled, line.deleted, line.expiring, line.expired, credits.low. Każde powiadomienie jest podpisane sekretem pokazanym raz przy utworzeniu (X-Xtream-Signature) i nigdy nie zawiera hasła; przycisk Test wysyła jedno od razu.

Powiązane tematy pomocy

Kolejne poradniki