Marketplace-In: criação automática de sellers via API

A funcionalidade Marketplace-In permite que marketplaces parceiros criem sellers automatizadamente diretamente via API, utilizando sua base de dados externa. 

Com isso, o processo deixa de depender da criação manual no painel e exige apenas a finalização da conta pelo titular indicado.

Esse fluxo garante mais escala, reduz esforço operacional e acelera o onboarding de novos sellers na plataforma Uappi.

O que é a API Marketplace-In

A API Marketplace-In é uma nova superfície de integração, separada das APIs existentes, criada especificamente para:

• permitir a criação de sellers via API;
  
• indicar, no momento da criação, o e-mail do titular responsável;
  
• automatizar o envio do convite de finalização da conta;
  
• ativar o seller automaticamente após a conclusão do titular.

Todo o processo é rastreável no painel da Uappi, com identificação da origem e do status do seller.

Importante: clique aqui para acessar os detalhes sobre a nova rota de API em Sellers > /v1/sellers/invitations.

Como funciona o onboarding automático de seller

O fluxo de criação e ativação do seller acontece em etapas bem definidas.

1. Criação do seller via API

O marketplace envia uma requisição para a API Marketplace-In contendo:

• dados cadastrais do seller;
  
• um identificador único do seller no marketplace de origem, evitando duplicidades;
  
• o e-mail do titular responsável.a

Após o envio, a API retorna:

• o id do seller criado na Uappi;
  
• o status inicial aguardando confirmação do titular.

Nesse momento, o seller já existe na plataforma, mas ainda não está ativo.

2. Convite para finalização do titular

Após a criação do seller, o sistema avalia o e-mail do titular informado.

• se o e-mail ainda não possui conta na Uappi, é enviado um e-mail de finalização para criação e validação da conta;
  
• se o e-mail já possui conta ativa, o sistema permite a ativação direta do seller, sem necessidade de novo cadastro.

Esse e-mail contém um link seguro para conclusão do processo.

3. Finalização da conta e ativação do seller

Ao acessar o link de finalização:

• o titular cria ou valida sua conta, quando necessário;
  
• o seller tem seu status alterado automaticamente para ativo;
  
• o usuário passa a ser vinculado ao seller com o papel de Titular.
  

A partir desse momento, o seller está apto a operar normalmente na plataforma.

Reenvio do e-mail de finalização

Enquanto o seller estiver com status aguardando confirmação do titular, é possível:

• reenviar o e-mail de finalização;
  
• garantir que o titular conclua o onboarding mesmo em casos de perda ou expiração do convite anterior.
  

Essa ação pode ser realizada pelo painel da Uappi.

Visualização no painel da Uappi

No painel administrativo, os sellers criados via Marketplace-In possuem informações específicas para facilitar o acompanhamento.

É possível visualizar:

• origem do seller: API (Marketplace-In);
  
• status atual: aguardando confirmação ou ativo;
  
• dados cadastrais enviados via API;
  
• vínculo do titular após a finalização.

Isso garante transparência e controle total sobre sellers criados automaticamente.

Principais benefícios da funcionalidade

• redução de esforço manual na criação de sellers;
  
• onboarding mais rápido e escalável;
  
• eliminação de duplicidades por identificador único;
  
• melhor experiência para o titular, que apenas finaliza a conta;
  
• rastreabilidade completa no painel da Uappi;
  
• ideal para operações de Marketplace-In com grande volume de sellers.

Quando utilizar a API Marketplace-In

Essa funcionalidade é indicada para marketplaces que:

• já possuem base própria de sellers;
  
• desejam automatizar o processo de cadastro na Uappi;
  
• precisam escalar a entrada de sellers sem intervenção manual;
  
• querem garantir governança e controle no onboarding.

Dúvidas?

Para mais informações sobre integrações e conteúdos sobre a plataforma, acesse o Help Center da Uappi.