No final, um pedido pago na sua plataforma cria uma linha e cada pagamento a renova, sem passar pelo painel. Você precisa de uma conta de parceiro (revendedor) com créditos e pacotes que ela 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 pela ponte de webhooks.
Crie uma chave de API
Entre com a conta de parceiro e abra Chave de API. Uma chave é exibida uma única vez, quando é criada — copie-a imediatamente. 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, então deixe a opção somente leitura desativada.
Escolha o conector
Abra Recursos → Todos os conectores e escolha a sua plataforma. A página dele lista os dados de conexão, os passos de instalação, um botão Baixar, o SHA-256 do arquivo para verificá-lo e até que ponto esse conector foi testado — alguns rodaram dentro da plataforma real, outros tiveram apenas o núcleo exercitado. O código-fonte é aberto; os mesmos arquivos são publicados no site dos conectores.
Instale-o na sua plataforma
Verifique o checksum e instale o arquivo onde a página do conector indicar: a pasta de módulos do WHMCS, Blesta ou FOSSBilling, o upload 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 você hospeda por conta própria. Um conector apenas chama a Reseller API com a sua chave: ele pode fazer o que a sua conta pode fazer, nada mais.
Configure-o
Nas configurações do conector, informe 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. Preços e pagamento ficam na sua plataforma: o painel não recebe dinheiro e não tem gateway.
Faça um pedido de teste
Peça o produto em um ambiente de teste da sua plataforma. O conector chama create_line com o pacote e um id de requisição; a linha aparece em Linhas com a duração do pacote como vencimento, e a sua plataforma recebe as credenciais dela. Uma renovação chama renew_line com seu próprio id de requisição, então uma nova tentativa após um erro de rede nunca é cobrada duas vezes. A página Chave de API lista as chamadas recentes com ação, resultado, código de erro, endereço e nome do conector.
Adicione webhooks (opcional)
Na página Chave de API, adicione um endpoint de webhook (um endereço https da sua plataforma) para os eventos desejados: line.created, line.renewed, line.enabled, line.disabled, line.deleted, line.expiring, line.expired, credits.low. Toda notificação é assinada com o segredo exibido uma única vez na criação (X-Xtream-Signature) e nunca contém uma senha; o botão Testar envia uma imediatamente.