Pular para o conteúdo principal

Sublojistas

Receba pagamentos em nome de vários lojistas com uma única integração da Volet.com.

O suporte a sublojistas permite que plataformas criem seus próprios produtos de pagamento sobre a Volet.com. Em vez de cadastrar cada lojista diretamente na Volet.com, a plataforma se integra uma única vez e processa pagamentos em nome dos próprios lojistas.

Os clientes continuam pagando pela sua plataforma ou pelos seus sublojistas, enquanto sua plataforma segue como o único ponto de integração com a Volet.com.

Cada pagamento pode ser associado a um sublojista específico, o que permite à plataforma identificar o pagamento, acompanhar pedidos e gerenciar a liquidação conforme a própria lógica de negócio.

Casos de uso típicos:

  • Provedores de pagamento white-label
  • Agregadores de lojistas
  • Marketplaces
  • Plataformas para criadores
  • Plataformas SaaS que atendem vários lojistas

Como funciona​

A plataforma se integra uma única vez à Volet.com e recebe pagamentos em nome de vários sublojistas.

O fluxo de pagamento geral:

  1. Sua plataforma cria uma solicitação de pagamento em nome de um sublojista.
  2. Sua plataforma inclui as informações do sublojista na solicitação de pagamento.
  3. O cliente conclui o pagamento pelo Hosted Checkout, pela sua própria interface de pagamento baseada na API ou por um fluxo com contrato inteligente.
  4. O valor é recebido conforme o modelo de pagamento escolhido.
  5. Sua plataforma associa o pagamento concluído ao pedido do sublojista correspondente.
  6. Sua plataforma faz o repasse ao sublojista conforme as próprias condições comerciais.

Modelos de integração​

O suporte a sublojistas está disponível em diferentes modelos de integração.

Hosted Checkout​

O Hosted Checkout oferece uma experiência de pagamento pronta e permite que sua plataforma associe cada pagamento a um sublojista específico.

Ao criar uma solicitação de pagamento do Hosted Checkout, você pode enviar o site do sublojista no parâmetro ac_submerchant_url.

Exemplo:

<input type="hidden" name="ac_submerchant_url" value="https://seller.example.com">

Você também pode incluir campos personalizados, por exemplo:

  • ID do sublojista
  • ID do vendedor
  • ID do pedido no marketplace
  • Número interno da fatura
  • ID do cliente

Esses valores são devolvidos sem alterações nas notificações de status e nos redirecionamentos do cliente, o que permite à sua plataforma associar os pagamentos concluídos ao sublojista e ao pedido corretos.

Veja Integração do Hosted Checkout para mais detalhes.

API com Hosted Checkout​

A API e o Hosted Checkout podem ser combinados em um único fluxo de pagamento.

A API cria a fatura de pagamento, enquanto o Hosted Checkout oferece a interface de pagamento para o cliente.

Nesse modelo, sua plataforma cria uma fatura cripto pela API e a associa a um pedido do sublojista antes de redirecionar o cliente para o Hosted Checkout.

Diferentemente do fluxo padrão do Hosted Checkout, a fatura de pagamento é criada pela sua plataforma, e não pelo Hosted Checkout. O Hosted Checkout apenas exibe a página de pagamento da fatura existente e cuida da experiência de pagamento do cliente.

Essa abordagem permite que sua plataforma:

  • Associe o pagamento a um sublojista antes de o cliente começar a pagar.
  • Mantenha a própria lógica de gestão de pedidos e faturas.
  • Evite criar e manter uma interface de pagamento para a plataforma ou para os sublojistas.
  • Deixe a Volet.com cuidar das instruções de pagamento, dos QR codes, do monitoramento da blockchain e das atualizações de status.

Sem o Hosted Checkout, o mesmo fluxo pode ser implementado inteiramente pela API. Nesse caso, sua plataforma ou cada sublojista precisa oferecer a própria interface de pagamento aos clientes.

Após a conclusão do pagamento, sua plataforma recebe ou consulta o status do pagamento e o associa ao sublojista correspondente pela referência da fatura ou do pedido.

Veja:

Pagamentos com contratos inteligentes​

As plataformas também podem atender sublojistas com pagamentos não custodiais via contratos inteligentes.

Nesse modelo, os clientes pagam diretamente das carteiras deles, e o pagamento é executado na blockchain por um contrato inteligente.

Diferentemente dos fluxos custodiais, a lógica de liquidação pode ser implementada diretamente no contrato inteligente. Por exemplo, cada pagamento pode ser dividido automaticamente entre a plataforma e um ou mais sublojistas no momento em que é executado.

Casos de uso típicos:

  • Compartilhamento de receita
  • Distribuição de comissões em marketplaces
  • Pagamentos para vários destinatários
  • Liquidação direta de carteira para carteira
  • Lógica de pagamento personalizada

Veja Compartilhamento de receita para mais detalhes.

Acompanhamento dos pagamentos de sublojistas​

Associe cada pagamento aos seus próprios identificadores para poder vinculá-lo ao sublojista e ao pedido correspondentes.

Identificadores comuns:

  • ID do sublojista
  • Site do sublojista
  • ID do pedido no marketplace
  • ID interno da fatura
  • ID do cliente
  • ID do lote de liquidação

No Hosted Checkout, você pode usar o parâmetro ac_submerchant_url e campos personalizados.

Em fluxos de faturas cripto via API, armazene o ID da fatura cripto junto com o pedido da sua plataforma e o registro do sublojista.

Em fluxos com contratos inteligentes, seu aplicativo pode usar metadados da transação, referências de pedidos ou eventos na blockchain, conforme a arquitetura de contrato inteligente escolhida.

Repasse aos sublojistas​

Nos fluxos de pagamento custodiais, o valor recebido é creditado na conta da Volet.com do lojista principal.

Após a conclusão do pagamento, o lojista principal é responsável pelo repasse ao sublojista conforme o próprio modelo comercial.

Você pode fazer o repasse aos sublojistas por um destes métodos:

  • Transferir criptomoedas para uma carteira cripto.
  • Transferir valores para a conta da Volet.com do sublojista.
  • Enviar uma transferência bancária manualmente pela interface da conta, quando disponível.
observação

No momento, transferências bancárias para sublojistas não estão disponíveis pela API. Se o repasse por transferência bancária for necessário, ele precisa ser feito manualmente pela interface da conta.

Sua plataforma também pode descontar a própria comissão antes de repassar o restante ao sublojista.

Por exemplo:

  1. O cliente paga 100 USDT.
  2. Sua plataforma recebe o pagamento.
  3. Sua plataforma retém uma comissão de 10 USDT.
  4. Sua plataforma repassa 90 USDT ao sublojista.

Compliance e análise​

O processamento para sublojistas está sujeito a análise.

Sua plataforma é responsável por saber quem são os sublojistas, quais bens ou serviços eles oferecem e se a atividade deles é permitida pelas políticas da Volet.com.

observação

Todos os requisitos de compliance, de atividades proibidas e de verificação aplicáveis aos lojistas também se aplicam aos sublojistas.

A Volet.com pode solicitar informações sobre seu modelo de sublojistas, processo de cadastro, categorias de negócio, sites, fluxos de transações e lógica de liquidação antes de habilitar ou aprovar a integração.

Como ativar​

Etapa 1. Fale com a gente​

O processamento para sublojistas é configurado individualmente. Agende uma conversa com a nossa equipe comercial.

Fale com a nossa equipe e descreva:

  • O modelo da sua plataforma
  • Os tipos de sublojistas que você atende
  • Os métodos de pagamento esperados
  • O fluxo de liquidação esperado

Nossa equipe vai ajudar você a escolher o modelo adequado:

  • Hosted Checkout, para uma experiência de pagamento pronta.
  • API com Hosted Checkout, para faturas cripto criadas previamente e a interface de pagamento do Hosted Checkout.
  • Integração somente por API, se sua plataforma oferece a própria interface de pagamento.
  • Contratos inteligentes, para fluxos não custodiais e lógica de liquidação personalizada na blockchain.

Etapa 2. Configure o recebimento de pagamentos​

Se você usa Hosted Checkout, API ou API com Hosted Checkout, crie e configure um gateway de pagamento na sua conta da Volet.com.

O gateway define como os pagamentos são recebidos, quais métodos de pagamento estão ativos e como as informações de status são tratadas.

Veja:

Se você usa um fluxo de pagamento com contrato inteligente, nossa equipe fornecerá a configuração de contrato necessária.

Etapa 3. Implemente a integração​

Implemente o fluxo de pagamento correspondente ao modelo de integração escolhido.

Para detalhes de implementação, veja:

Etapa 4. Configure os dados dos sublojistas e o mapeamento de pedidos​

Defina como sua plataforma vai enviar, armazenar e associar as informações dos sublojistas.

Etapa 5. Teste os fluxos de pagamento e repasse​

Antes de entrar em produção, teste:

  • Criação de pagamentos
  • Identificação de sublojistas
  • Tratamento do status dos pagamentos
  • Associação de pedidos
  • Cálculo de comissões
  • Repasse aos sublojistas
  • Cenários de pagamentos com falha e cancelados

Etapa 6. Entre em produção​

Depois que a integração for aprovada, configurada e testada, sua plataforma pode começar a receber pagamentos em nome dos sublojistas.

Limitações​

  • Sua plataforma é responsável pelo repasse ao sublojista.
  • O repasse por transferência bancária a sublojistas não está disponível pela API.
  • Alguns modelos de negócio de sublojistas podem exigir análise de compliance adicional antes da ativação.