No final, uma encomenda paga na sua plataforma cria uma linha e cada pagamento renova-a, sem passar pelo painel. Precisa de uma conta de parceiro (revendedor) com créditos e pacotes que possa vender, e de uma plataforma com conector — WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WordPress com WooCommerce ou Easy Digital Downloads, Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext, ou Shopify, Upmind e Invoice Ninja através da ponte de webhooks.
Crie uma chave de API
Inicie sessão com a conta de parceiro e abra API Key. Uma chave é mostrada uma única vez, quando é criada — copie-a de imediato. Crie uma chave adicional por sistema, com um nome e os endereços autorizados a usá-la, para que uma possa ser revogada sem afetar as outras; o conector precisa de uma chave com permissão de escrita, por isso deixe a opção só de leitura desativada.
Escolha o conector
Abra Resources → All Connectors e escolha a sua plataforma. A página do conector lista os dados de ligação, os passos de instalação, um botão Download, o SHA-256 do ficheiro para o verificar e até que ponto esse conector foi testado — alguns correram dentro da plataforma real, outros tiveram apenas o núcleo exercitado. O código-fonte é aberto; os mesmos ficheiros são publicados no sítio dos conectores.
Instale-o na sua plataforma
Verifique o checksum e instale o ficheiro onde a página do conector indicar: a pasta de módulos do WHMCS, Blesta ou FOSSBilling, o carregamento de plugins do WordPress, a pasta de addons do Odoo, o instalador de extensões do OpenCart, e assim por diante. A ponte de webhooks para Shopify, Upmind e Invoice Ninja é uma pequena aplicação PHP que aloja por si próprio. Um conector limita-se a chamar a Reseller API com a sua chave: pode fazer o que a sua conta pode fazer, nada mais.
Configure-o
Nas definições do conector, introduza o endereço do servidor da API (o caminho /reseller/v1) e a chave e depois associe cada produto da sua plataforma a um pacote que o seu grupo possa vender. Os preços e o pagamento ficam na sua plataforma: o painel não recebe dinheiro e não tem gateway.
Faça uma encomenda de teste
Encomende o produto num ambiente de teste da sua plataforma. O conector chama create_line com o pacote e um id de pedido; a linha aparece em Lines com a duração do pacote como validade, e a sua plataforma recebe as respetivas credenciais. Uma renovação chama renew_line com o seu próprio id de pedido, pelo que uma nova tentativa após um erro de rede nunca é cobrada duas vezes. A página API Key lista as chamadas recentes com ação, resultado, código de erro, endereço e nome do conector.
Adicione webhooks (opcional)
Na página API Key, adicione um endpoint de webhook (um endereço https da sua plataforma) para os eventos pretendidos: line.created, line.renewed, line.enabled, line.disabled, line.deleted, line.expiring, line.expired, credits.low. Cada notificação é assinada com o segredo mostrado uma única vez na criação (X-Xtream-Signature) e nunca transporta uma palavra-passe; o botão Test envia uma de imediato.