Este documento descreve o passo a passo para publicar a integração do seu serviço no marketplace Altegio. No contexto do marketplace, cada integração é chamada de «aplicativo».
1º Passo — Crie seu primeiro aplicativo
- Obtenha acesso à conta de desenvolvedor por este link. Observação: as ferramentas de desenvolvedor ficam disponíveis apenas na conta com a qual você as criou.
- Na conta de desenvolvedor, crie seu primeiro aplicativo para o marketplace.
2º Passo — Integre com a API do marketplace
- Implemente a solicitação para conectar seu aplicativo ao local do usuário.
- Implemente a transferência de dados de pagamento do seu serviço.
- Implemente o processamento do webhook de desconexão da integração no lado Altegio.
Passo 2.5 — Teste no seu próprio local antes da moderação
Antes de enviar o aplicativo para moderação, instale o rascunho em um local que você gerencia e faça chamadas de API reais. É self-service — sem moderação.
- Na conta de desenvolvedor, abra «General info» do aplicativo e copie «Link to request a review» (ver Geração do link do aplicativo).
- Abra esse link como administrador do seu local de teste e clique em «Conectar». O aplicativo é vinculado ao local com status pending.
- Do seu serviço, envie a solicitação de conexão em até 1 hora para ativar o vínculo — ver Conectando a integração pelo marketplace.
- Confirme que o aplicativo está active e comece a chamar a API do local com o token do usuário do sistema.
Endpoints, tokens, hosts e exemplos prontos para copiar estão no guia para desenvolvedores Install & test your app before moderation.
3º Passo — Passe pela moderação
Para publicar seu aplicativo no marketplace Altegio, é necessário passar pela moderação. Após a criação, aparecerá na ficha do aplicativo a seção «Publicar» com um checklist que ajuda a preparar o aplicativo para a moderação.
Na moderação, a equipe da Altegio verifica se o seu aplicativo:
- Conecta-se corretamente ao local do cliente.
- Transmite os dados de pagamento.
- Transmite os dados de estornos.
- Processa corretamente a desconexão e a reconexão da integração.
- Processa corretamente a conexão quando o usuário já está cadastrado no seu sistema.
Ao concluir o desenvolvimento da integração com a API do marketplace e testar seu funcionamento do seu lado, preencha os campos do checklist. O botão «Enviar para moderação» ficará disponível após o preenchimento dos campos obrigatórios.
Instruções detalhadas sobre a moderação estão aqui.
Assim que a Altegio concluir a verificação e todos os erros detectados forem corrigidos, sua integração ficará disponível aos usuários do marketplace na categoria escolhida.