Home
XtreamUIPro

Tutorial

Een shop koppelen met een connector

Laat je facturatie- of shopplatform zelf lijnen aanmaken en verlengen: een API-sleutel, de connector voor je platform, een testbestelling en webhooks voor wat daarna gebeurt.

Aan het einde maakt een bestelling die op je platform is betaald een lijn aan en verlengt elke betaling hem, zonder het dashboard. Je hebt een partneraccount (reseller) nodig met credits en pakketten die het mag verkopen, en een platform met een connector — WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WordPress met WooCommerce of Easy Digital Downloads, Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext, of Shopify, Upmind en Invoice Ninja via de webhookbridge.

Een API-sleutel aanmaken

Meld je aan met het partneraccount en open API Key. Een sleutel wordt eenmalig getoond, bij het aanmaken — kopieer hem meteen. Maak per systeem een extra sleutel aan, met een naam en de adressen die hem mogen gebruiken, zodat er een kan worden ingetrokken zonder de andere aan te raken; de connector heeft een sleutel nodig die mag schrijven, dus laat de alleen-lezenvlag uit.

De pagina API Key van een partneraccount: de sleutel, de extra sleutels per systeem, de webhooks en de recente aanroepen.
De pagina API Key van een partneraccount: de sleutel, de extra sleutels per systeem, de webhooks en de recente aanroepen.

De connector kiezen

Open Resources → All Connectors en kies je platform. De pagina toont de verbindingsgegevens, de installatiestappen, een Download-knop, de SHA-256 van het bestand om het te verifiëren, en hoe ver die connector is getest — sommige draaiden binnen het echte platform, bij andere is alleen de kern getest. De broncode is open; dezelfde bestanden worden gepubliceerd op de connectorsite.

De pagina All Connectors: één kaart per platform met zijn versie en hoe ver het is getest.
De pagina All Connectors: één kaart per platform met zijn versie en hoe ver het is getest.

Installeren op je platform

Controleer het controlegetal en installeer het bestand waar de pagina van de connector dat aangeeft: de modulemap van WHMCS, Blesta of FOSSBilling, de pluginupload van WordPress, de addonsmap van Odoo, de extensie-installer van OpenCart, enzovoort. De webhookbridge voor Shopify, Upmind en Invoice Ninja is een kleine PHP-applicatie die je zelf host. Een connector roept alleen de Reseller-API aan met jouw sleutel: hij kan doen wat jouw account kan, niets meer.

De pagina van de WHMCS-connector: verbindingsgegevens, installatiestappen, de download en zijn SHA-256.
De pagina van de WHMCS-connector: verbindingsgegevens, installatiestappen, de download en zijn SHA-256.

Configureren

Voer in de instellingen van de connector het adres van de API-server (het pad /reseller/v1 ervan) en de sleutel in, en koppel daarna elk product van je platform aan een pakket dat je groep mag verkopen. Prijzen en betaling blijven op je platform: het paneel int geen geld en heeft geen gateway.

Een testbestelling plaatsen

Bestel het product in een testomgeving van je platform. De connector roept create_line aan met het pakket en een request-id; de lijn verschijnt in Lijnen met de looptijd van het pakket als vervaldatum, en je platform ontvangt zijn inloggegevens. Een verlenging roept renew_line aan met een eigen request-id, zodat een nieuwe poging na een netwerkfout nooit dubbel wordt afgeschreven. De pagina API Key toont de recente aanroepen met actie, resultaat, foutcode, adres en connectornaam.

De pagina Lijnen na een testbestelling: de nieuwe lijn met het pakket, de vervaldatum en de verbindingen waar de connector om vroeg.
De pagina Lijnen na een testbestelling: de nieuwe lijn met het pakket, de vervaldatum en de verbindingen waar de connector om vroeg.

Webhooks toevoegen (optioneel)

Voeg op de pagina API Key een webhookendpoint toe (een https-adres van je platform) voor de gebeurtenissen die je wilt: line.created, line.renewed, line.enabled, line.disabled, line.deleted, line.expiring, line.expired, credits.low. Elke melding is ondertekend met het geheim dat bij het aanmaken eenmalig wordt getoond (X-Xtream-Signature) en bevat nooit een wachtwoord; de knop Test stuurt er direct een.

Gerelateerde helponderwerpen

Volgende tutorials