Hem
XtreamUIPro

Tutorial

Anslut en butik med en connector

Låt din fakturerings- eller butiksplattform skapa och förnya linjer på egen hand: en API-nyckel, connectorn för din plattform, en testorder och webhooks för det som händer sedan.

I slutet skapar en order som betalats på din plattform en linje och varje betalning förnyar den, utan instrumentpanelen. Du behöver ett partnerkonto (reseller) med krediter och paket det får sälja, och en plattform med en connector — WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WordPress med WooCommerce eller Easy Digital Downloads, Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext, eller Shopify, Upmind och Invoice Ninja via webhook-bryggan.

Skapa en API-nyckel

Logga in med partnerkontot och öppna API Key. En nyckel visas en gång, när den skapas — kopiera den direkt. Skapa en extra nyckel per system, med ett namn och de adresser som får använda den, så att en kan återkallas utan att röra de andra; connectorn behöver en nyckel som får skriva, så lämna den skrivskyddade flaggan av.

Sidan API Key för ett partnerkonto: nyckeln, de extra nycklarna per system, webhooks och de senaste anropen.
Sidan API Key för ett partnerkonto: nyckeln, de extra nycklarna per system, webhooks och de senaste anropen.

Välj connector

Öppna Resources → All Connectors och välj din plattform. Dess sida listar anslutningsuppgifterna, installationsstegen, en Download-knapp, filens SHA-256 för att verifiera den, och hur långt den connectorn har testats — vissa kördes i den riktiga plattformen, andra fick bara sin kärna prövad. Källkoden är öppen; samma filer publiceras på connectorsajten.

Sidan All Connectors: ett kort per plattform med dess version och hur långt den har testats.
Sidan All Connectors: ett kort per plattform med dess version och hur långt den har testats.

Installera den på din plattform

Verifiera kontrollsumman och installera filen där connectorns sida anger: modulmappen i WHMCS, Blesta eller FOSSBilling, plugin-uppladdningen i WordPress, addons-mappen i Odoo, tilläggsinstallationen i OpenCart, och så vidare. Webhook-bryggan för Shopify, Upmind och Invoice Ninja är en liten PHP-applikation som du hostar själv. En connector anropar bara Reseller API med din nyckel: den kan göra det ditt konto kan göra, inget mer.

Sidan för WHMCS-connectorn: anslutningsuppgifter, installationssteg, nedladdningen och dess SHA-256.
Sidan för WHMCS-connectorn: anslutningsuppgifter, installationssteg, nedladdningen och dess SHA-256.

Konfigurera den

Ange adressen till API-servern (dess sökväg /reseller/v1) och nyckeln i connectorns inställningar, och koppla sedan varje produkt på din plattform till ett paket som din grupp får sälja. Priser och betalning stannar på din plattform: panelen tar inte emot några pengar och har ingen gateway.

Lägg en testorder

Beställ produkten i en testmiljö på din plattform. Connectorn anropar create_line med paketet och ett request-id; linjen visas i Linjer med paketets löptid som förfallodatum, och din plattform får dess inloggningsuppgifter. En förnyelse anropar renew_line med ett eget request-id, så att ett nytt försök efter ett nätverksfel aldrig debiteras två gånger. Sidan API Key listar de senaste anropen med åtgärd, resultat, felkod, adress och connectorns namn.

Sidan Linjer efter en testorder: den nya linjen med det paket, förfallodatum och de anslutningar connectorn bad om.
Sidan Linjer efter en testorder: den nya linjen med det paket, förfallodatum och de anslutningar connectorn bad om.

Lägg till webhooks (valfritt)

På sidan API Key lägger du till en webhook-endpoint (en https-adress på din plattform) för de händelser du vill ha: line.created, line.renewed, line.enabled, line.disabled, line.deleted, line.expiring, line.expired, credits.low. Varje avisering signeras med den hemlighet som visas en gång vid skapandet (X-Xtream-Signature) och innehåller aldrig ett lösenord; knappen Test skickar en direkt.

Relaterade hjälpämnen

Nästa tutorials